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2 Introduction 


SECTION 1. INTRODUCTION 


This manual contains a detailed description of the ROM Basic Input/Output System (BIOS) of the 
HP Vectra Personal Computer. Entry points, including the industry standard ROM BIOS entry 
points and function calls, are documented in this manual. 


This manual deals extensively with programming and programming concepts. It presumes that 
the reader is familiar with the Microsoft Macro Assembler (MASM) and the Intel iAPX 80286 
processor architecture. 


Related documents which may be of interest to programmers and advanced users are listed at 
the end of this volume in the References section. 


1.1 System Software 


Software operating on the system may be viewed as a three-level hierarchy: application 
programs, operating system, and ROM BIOS. These three levels are defined as follows: 


Application Programs—An application program Is the top level of software. It performs 
application-specific functions (i.e., soreadsheet or word processing functions). Application 
programs rely on either DOS or the ROM BIOS for system functions such as character or disc 
/O. 


Operating System—The operating system provides the control and support functions 
necessary for an application program to be executed. The operating system provides file- 
oriented functions, as well as providing basic support for character I/O. 


ROM BlOS—The ROM BIOS provides the interface between operating system software and 
the hardware. The ROM BIOS provides a dual function; it constitutes the low level interface 
between the hardware and operating system, as well as providing extended functions to 
application programs. 
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The higher the software level, the more powerful the functions provided by the software. 
However, along with this power often comes additional overhead which reduces performance 
and flexibility. A system programmer should choose the level of software interface required by 
the individual set of design constraints. It is good programming practice to use the highest level 
of system software that gets the job done. Some system functions can only be performed on the 
highest level, since only system software supports the function. However, other system functions 
may be performed at more than one level. Using a lower level such as the ROM BIOS provides 
improved speed of execution and additional flexibility. Using ROM BIOS routines may affect 
program portability to future HP products, and to other industry standard PC's. 


1.2 ROM BIOS 


The ROM BIOS provides a powerful set of system functions, allowing application programs full 
access to the capabilities of the system while maintaining a hardware-independent interface. 


The ROM BIOS allows the programmer or system designer to tailor the system to a specific set of 
design constraints. Some of the tailoring methods provided to the programmer are: 


@ The number of interrupts can logically expand to fit requirements. 


@® Adapter cards can obtain a limited amount of RAM from the system BIOS without installing 
device drivers. 


@ Applications can expand the features of the keyboard without replacing the industry 
standard driver (INT 16H). 


@ The ROM resident mouse driver system can provide the ability to use various input 
peripherals with applications not specifically written for them. 


These methods maintain application compatibility with minimal effect on system performance. 
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SECTION 2. ROM BIOS OVERVIEW 


The ROM BIOS is divided into two components, the Standard BIOS (STD-BIOS) and the Extended 
BIOS (EX-BIOS). The STD-BIOS supports the industry standard set of BIOS functions. The EX-BIOS 
is unique to the HP Vectra. It provides a wide range of system functions and support for HP 
peripherals. The STD-BIOS and EX-BIOS are discussed later in this section. Both the STD-BIOS and 
the EX-BIOS are contained in the system ROM which resides at the top of system memory. 


Note 


Throughout the remainder of this manual the terms BIOS, STD-BIOS, and EX-BIOS will 
be used. STD-BIOS and EX-BIOS are defined above. The term ROM BIOS will be used 
to indicate the union of STD-BIOS and EX-BIOS. 


This section contains an overview of the components of the ROM BIOS. These components are 
the interrupt vectors, code modules, and data structures. Interrupt vectors form the link between 
the operating system, applications, and the ROM BIOS. The code modules perform the ROM 
BIOS functions. Data structures provide the means for the ROM BIOS (and to some extent the 
applications) to maintain driver variables, data buffers, etc. 


2.1 Memory Locations 


Code modules are accessed through interrupt vectors. The interrupt vectors reside in the first 
1KB of system RAM. Usually a code module has an associated data structure. The data structures 
for the STD-BIOS code modules reside in system RAM in absolute memory locations 00400H 
through OOSFFH. The data structures for the EX-BIOS code module reside at the top of system 
RAM. The address of the EX-BIOS data area will vary depending on the particular configuration 
of the system. 


Figure 2.1 shows the components of the ROM BIOS and their location within the system 
memory. Each of the ROM BIOS components is discussed in detail in the remainder of this 
section. 
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Memory Map Block Diagram 


OOO000H 

000400H 
STD-BIOS Data Area 

0O00600H 


STD-BIOS Data Expansion Area and 
Temporary DOS Buffers 
Disc Operating System — (DOS) 
Variable* 
Application Program Area 
Top of Available RAM** 


EX-BIOS Data Area 
Top of RAM*** 


000700H 


OAOO00H 


Video Display Memory 


OCOO00H 


Video Adapter Card ROM 

0C8000H 
Adapter Card Option ROM 

OE0000H 
Processor ROM Extension 

OFOOOOH 
BIOS ROM 

100000H 


Extended Memory (Up to 15MB) 


OFEOOOOH 
Image of ROM at OEQ000H — OFFFFFH 


“The length of the operating system is revision dependent. 

**The Top of Available RAM is dependent on system configuration, in a 
256KB system it is usually O3FOOOH while in 640KB system it is usually 
O9FOOOH. 

***The Top of RAM is dependent on system configuration, in a 256KB 
system it is OSFFFFH while in 640KB system it is O9FFFFH. 


Figure 2.1 
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2.2 Interrupts 


The interface to the BIOS is through the interrupt structure of the 80286. The system allows for 
three types of interrupts. 


@ Processor Interrupts—These interrupts allow system software to recover from error 
conditions and other hardware exceptions. 


@ Hardware Interrupts—These interrupts are generated by the 8259A interrupt controllers on 
the processor board. Hardware interrupts indicate that a system hardware component or 
peripheral requires service. 


@ Software Interrupts—These interrupts are generated through the software ‘INT n’ 
instruction. Software interrupts allow system functions to be quickly and easily called by any 
program. 


Interrupt vectors for the processor interrupts are defined by the 80286. Interrupt vectors for the 
hardware interrupts are mapped by the values programmed into the 8259A interrupt controllers 
which are initialized by the ROM BIOS. Processor and/or hardware interrupts may be ‘simulated’ 
by a software interrupt mapped to the same interrupt vector. For example, Interrupt O is mapped 
by the 80286 for Divide by 0 error. The service routine for this error condition may be executed 
by an INT 0 instruction. 


Each interrupt has an interrupt vector associated with it. The interrupt vector contains the Code 
Segment and Instruction Pointer of the service routine for that interrupt. Each of these vectors 
consists of two words (four bytes). The iAPX 80286 architecture supports 256 interrupt vectors 
which occupy the first 1024 bytes (QOOOOH-O03FFH) of system memory. 


The interrupt vectors maintain industry standard compatibility while offering the expanded 
capabilities of the HP EX-BIOS functions. Table 2.1 lists these assignments. 


In order for the system to function properly, processor and hardware interrupt vectors are 
initialized to valid service routines. Most unused vectors point to a null routine in the BIOS which 
issues an End-of-Interrupt (EOI) signal to the 8259A(s) when required and returns. The Keyboard 
Break and Timer Tick software interrupt vectors point to an IRET instruction in the BIOS. These 
vectors are indicated by an IRET in table 2.1. Several software vectors are used as pointers to 
data blocks instead of interrupt service routines. These vectors are indicated by a PT in table 2.1. 
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Table 2.1 


Interrupt Vector Assignments 


Address Int Function Type* Service Routine** 


O00-003H 
004-007H 
O08-O0BH 
OOC-OOFH 
010-013H 


014-017H 
018-01BH 
01C-O1FH 
O020-023H 
024-027H 


028-O02BH 
O2C-O2FH 
030-033H 
034-037H 
038-03BH 


03C-O3FH 
040-043H 
044-047H 
048-O04BH 
O4C-O4FH 


050-053H 
054-057H 
058~-O5BH 
O5C-O5FH 
060-063H 


064-067H 
068-06BH 
06C-06FH 
070-073H 
074-077H 


078-O07BH 
O7C-O7FH 
080-083H 
084-087H 
088-O08BH 


Oo ON OVUT] B WN © 
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Divide by Zero 

Single Step 
Nonmaskable Interrupt 
Breakpoint 

Arithmetic Overflow 


Print Screen 
Invalid Opcode 
Reserved 
Timer Interrupt 
Keyboard ISR 


Reserved 

Serial Port 1 ISR 
Serial Port 0 ISR 
Printer Port 1 ISR 
Diskette ISR 


Printer Port O ISR 
Video 

Equipment Check 
Memory Size 
Diskette/Hard Disc 


Serial 
System Functions 
Keyboard 
Printer 
Reserved 


Boot 

Time and Date 
Keyboard Break 
Timer Tick 

Video Parameter Table 


Diskette Parameter Table 
Graphics Character Table 
Program Terminate 

DOS Function Calls 

DOS Terminate Address 


er ee 


STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOD 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 
STD-BIOS 
TD-BIOS 
N/A 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 
DOS 
DOS 
DOS 


(DRVR) 


(DRVR) 
(DRVR) 
(DRVR) 
(DRVR) 
“ERET) 
(DRVR) 
(DRVR) 
(IRET) 
(IRET) 


Address 
O8C-O8FH 


Int Function 
DOS <CTRL>-< Break > 


Type* Service Routine** 


Address SW DOS 
090-093H 24 DOS Critical Error SW DOS 
094-O097H 25 DOS Absolute Disc Read SW DOS 
098-O09BH DOS Absolute Disc Write SW DOS 


O9C-O9FH DOS Terminate Stay Resident § SW DOS 


OAOQ-OCBH Reserved for DOS SW DOS 
OCC-OCFH 33 HP Mouse SW EX-BIOS (DRVR) 
ODO-OFFH 34-3F Reserved for DOS SW DOS 

Alternate Diskette SW STD-BIOS 
Hard Disc Parameter Table (0) PT STD-BIOS 


Reserved SW STD-BIOS 
-11BH 46 Hard Disc Parameter Table (1) PT STD-BIOS 
-17FH 47-5F Reserved SW STD-BIOS 
-19FH 60-67 Reserved for User Programs SW N/A 

-1A3H 68 8041 Service Request ISR HW EX-BIOS 


Keyboard OBF ISR HW EX-BIOS 
Reserved HW EX-BIOS 
-1AFH 6B Reserved HW EX-BIOS 
HP-HIL Controller ISR HW EX-BIOS 
Reserved HW EX-BIOS 


Reserved HW EX-BIOS 
-1BFH 6F EX-BIOS Entry Point SW EX-BIOS (DRVR) 
-1C3H 70 Real-time Clock ISR (IRQ 8) HW STD-BIOS 
-1C7H 71 SW Redirected (IRQ 9) HW STD-BIOS 


Reserved (IRQ 10) HW STD-BIOS 


Reserved (IRQ 11) HW STD-BIOS 

-1D3H 74 Reserved (IRQ 12) HW STD-BIOS (Ul) 
-1D/7H 75 Coprocessor (IRQ 13) HW STD-BIOS 
-1DBH 76 Hard Disc ISR (IRQ 14) HW STD-BIOS 
10C-1DFH 77 Reserved (IRQ 15) HW STD-BIOS 


1EQ-1FFH 78-7F Not Used SW N/A 
200-3C3H 80-FO Reserved SW N/A 
3C4-3FFH F1-FF Not Used 


* Pl—Processor interrupt ** Ul—Unused interrupt ISR 
HW—Hardware interrupt IRET—Interrupt returned 
SW—Software interrupt DRVR—Application callable entry point 


PT—Interrupt vector used as pointer to data. 
N/A—Not applicable 
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2.3 ROM BIOS, Drivers and Functions 


The ROM BIOS is comprised of many drivers. For example, there is a driver to perform video 
functions, one to perform disc functions, etc. The ROM BIOS drivers are organized into two 
components. One component contains the STD-BIOS drivers that support the STD-BIOS 

functions. The second component contains EX-BIOS drivers that support unique HP features. 


Each driver supports one or more functions. A function can be viewed as a specific task. For 
example, the Video Driver supports 22 separate functions that perform tasks such as setting the 
display mode, moving the cursor, and displaying characters. 


2.3.1 STD-BIOS Drivers 


Drivers in the STD-BIOS are accessed through an interrupt. STD-BIOS drivers are accessed through 
interrupts OSH and 10H through 1CH. Drivers are accessed by performing a software INT n 
instruction, where n Is the interrupt number assigned to the driver (refer to table 2.1.) 


The function code and any required data are passed in the 80286 registers. Data passing 
conventions for STD-BIOS drivers vary, however, there are aspects which are common. 


@ Most of the STD-BIOS drivers support more than one function. Therefore, multi-function 
drivers must have the desired function code passed as part of the data. The AH register is 
used on all multi-function drivers to pass the function code. 


@ Byte and word data is passed in the internal registers of the 80286. Registers AL, BX, CX, 
and DX are usually used for this purpose. The register assignments and number of registers 
used depend on the driver and driver function. 


@ \f the amount of data cannot fit in the internal registers of the 80286, a data buffer in 
system memory Is used. This buffer is usually pointed to by ES:BX, ES:BP or ES:SI. 


@® Drivers may modify one or more registers. The registers which are maintained and the 


registers which are modified vary from driver to driver. The registers which are modified are 
listed in each function description. 
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Calling STD-BIOS Drivers 


The following program example demonstrates accessing a typical STD-BIOS driver. The function 
sets the position of the cursor on display page 0 to row 20, column 10. The function code (02H) 
is passed in register AH. The row position, the column position, and the page number are passed 
respectively in DH, DL, and BH. 


MOV AH,O2H (Function number 

MOV DH,14H ;Row number (Row 20) 

MOV DL,QAH {Column number (Column 10) 
MOV BH,OH /Page number 

INT 10H (Call Video driver 


The STD-BIOS drivers support all industry standard BIOS functions. In addition, many of the 
drivers have additional functions that support enhanced features. These functions are referred to 
as ‘HP extensions’ throughout the remainder of this manual. These enhancements are accessed 
through function code (O6FH) of their respective driver. Most of these extended functions are 
further divided into subfunctions. For example, the HP extended function for the Video driver has 
six subfunctions which allow access to the enhanced features of the Multimode Video Display 
Adapter. The function code (O6FH) is placed in the AH register and the subfunction code in AL 
for all HP extensions. 


The following example uses HP extensions to turn off the cursor control pad on the keyboard. 


MOV AH,6FH , HP Function 

MOV AL,O7H , Switch Keyboard 

MOV BL,O2H , Disable CCP: Turn Cursor Control 
, Pad Off 

INT 16H ; Call Keyboard Driver 


2.3.2 EX-BIOS Drivers 


The EX-BIOS drivers provide a wide range of functions not found in the STD-BIOS drivers. The EX- 
BIOS drivers are accessed through a single software interrupt vector. This interrupt (O6FH) will be 
referred to as INT HP__ENTRY. Due to the large number of EX-BIOS drivers, it would be 
impossible to give each driver its own interrupt vector and still maintain industry standard 
compatibility. Therefore, each driver is assigned its own number which is placed in the BP 
register. This manual refers to these numbers by the names assigned in Appendix E. 
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Calling EX-BIOS Drivers 


As with the STD-BIOS drivers, each EX-BIOS driver may support one or more functions. A 
function code placed in the AH register selects the desired function within the driver. In addition, 
a subfunction code passed in the AL register is required by many EX-BIOS functions. 


The following program example demonstrates access to a typical EX-BIOS driver. The function 
executes a beep’ on the speaker. 


Mov AH,3AH ; Function: F_SND__BEEP 
MOV BP,12H ; Driver Name: V_SYSTEM 
PUSH DS : 
INT 6FH ; EX-BIOS Call: HP__LENTRY 
POP DS 


4 


On leaving the EX-BIOS driver the BP and DS registers will be modified while the AH register 
usually contains the return status of the driver call. 


2.3.3  EX-BIOS Standard Functions 


Many EX-BIOS drivers support a standard set of functions and subfunctions as listed in table 2.2. 
While these functions and subfunctions are defined, it is not required that they all be 
implemented by every driver. In addition, EX-BIOS drivers may implement functions other than 
those listed. Most EX-BIOS drivers use a standard set of return status codes reported in the AH 
register at the completion of a driver’s function call. Some of these return status codes and their 
definitions are listed in table 2.3. A driver may report a return status code of 
RS__UNSUPPORTED (02H) for a given function. 


Function codes and return statuses are described in detail in Appendix G. 
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Table 2.2 
EX-BIOS Defined Functions 


Function Register 
Subfunction AH AL Definition 
F__ISR 00 Responds to a logical Interrupt Service Request (ISR). 


F_ SYSTEM Executes one of several standard subfunctions. 
SF__INIT O02 00 Starts the initialization of a driver. 
SF__START 02 02 Completes the initialization process of the driver. 
SF__REPORT__STATE 02 04 _ Reports the state of the driver. 
SF__VERSION__DESC 02 06 Reports the revision number and datecode of the 


driver. 
SF__DEF__ATTR 02 08 Reports the default configuration of the driver. 
SF__GET__ATTR O2 OA _ Reports the current configuration of the driver. 
SF__SET__ATTR O2 OC Overrides the current configuration of the driver. 
SF__OPEN O2 OE Reserves the driver for exclusive access. Requests 
any resources required by the driver. 
SF__CLOSE O2 10 Releases the driver from exclusive access. 
SF__TIMEOUT O02 12 Reports to the driver that a requested timeout has 
occurred. 
SF__INTERVAL O02 14 Reports to the driver that a requested 60 Hz interval 
has expired. 


SF__TEST 
F__IO__CONTROL 


O2 16 Performs a hardware test. 


Executes the following subfunctions and any driver 
dependant subfunctions. 


SF__LOCK 04 00 Reserves the sub-address device specified for 
exclusive access. 
SF__UNLOCK O04 02 Releases the sub-address specified from the 


exclusive access. 


F__PUT__BYTE Writes a byte of data. 
F__GET__BYTE 08 Reads a byte of data. 
F__PUT__BUFFER OA Writes a variable length buffer of data (supported 


by character devices). 

F__PUT__BLOCK OA Writes a fixed length buffer of data (supported by 
block devices). 

F__GET__BUFFER OC Reads a variable length buffer of data (supported by 
character devices). 

F__GET__BLOCK OC Reads a fixed length block of data (supported by 


block devices). 
Writes a word of data. 
Reads a word of data. 


F__PUT__WORD 
F__GET__WORD 
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2.3.4 EX-BIOS Parameter Passing Conventions 


When calling EX-BIOS drivers, the function code is placed in the AH register, and the subfunction 
code (if any) in the AL register. Note that the function and subfunction codes are multiples of 
two in order to facilitate decoding by the drivers. 


The general parameter passing conventions used by the EX-BIOS drivers are also defined. These 
register conventions are as follows: 


On Entry: BP = V__DRIVER__NAME 
AH = F_FUNC__CODE 
AL = SF__FUNC__CODE (if required by driver) 
CX = On write: byte count (if required by driver) 
On read: maximum permissible byte count (if required by driver) 
ES:DI = Buffer pointer or context area (if required by driver) 
On Exit: AH = Return status 
CX = On read: byte count (if required by driver) 
On write: number of bytes written (if required by driver) 
ES:D!| = Buffer pointer or context area (if required by driver) 


DS, BP Always modified (unless otherwise indicated) 


2.3.5 EX-BIOS Return Status Codes 


EX-BIOS drivers are expected to report a Return Status Code upon completion. This code is 
returned in the AH register. Several status codes have been defined and are listed in table 2.3. 
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Table 2.3 
EX-BIOS Return Status Codes 


Return Status Code Indication 


RS__ SUCCESSFUL QOOH The requested function executed correctly. 
RS__UNSUPPORTED OO2H The requested function or subfunction is 
not implemented or is unsupported. 


RS__ FAIL OFEH The driver failed the operation in an error 
State. 


RS__BAD__PARAMETER OFAH The driver received a bad parameter. 

RS__ BUSY OF8H The requested driver is busy. 

RS__NO__VECTOR OF6H EX-BIOS Vector table is out of RAM or 
room for more drivers. 

RS__ OFFLINE OF4H Device is offline. 

RS__OUT__OF__PAPER OF2H Device is out of paper. 


If additional drivers are installed in the system, they should conform to the defined statuses 
wherever possible. However, to maintain coding efficiency and/or functional accuracy, a driver 
may create a return status other than those listed in Table 2.3. 


Note 


Return status conditions are always multiples of two. Negative return status codes 
indicate error conditions, while positive status codes indicate exceptional conditions 
to the caller. For example, the status code RS__UNSUPPORTED indicates the driver 
does not support a function which may or may not be an error, while RS__OUT__ 
OF__PAPER requires some kind of response by the caller. 
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2.4 Data Structures 


BIOS drivers require RAM data area to perform their functions. The layout and placement of the 
data areas for the STD-BIOS and EX-BIOS drivers differ. This is discussed in the following am, 
subsections. : 


2.4.1 STD-BIOS Data Structures 


The data area for the STD-BIOS is in absolute memory locations OO400H through OO5FFH, which 
conforms to the industry standard. Table 2.4 summarizes the assignments within this block of 
memory. Refer to Appendix B for a detailed description of these data fields. 


Table 2.4 
STD-BIOS Data Area Summary 


Address Function 


4O00H-407H RS-232 Communications Port Addresses 
408H-40FH Parallel Printer Port Addresses 
410H-416H System Data and Flags 

417H-43DH Keyboard Data Area 

43EH-448H Flexible Disc Data Area 


449H-466H Video Display Data Area 
467H-46BH System Data and Flags 


46CH-470H Timer Data Area 
471H-473H System Data Flags 
474H-477H Hard Disc Data Area 


478H-4/7BH Printer Timeout Counters 

47CH-47FH RS-232 Communications Port Timeout Counters 

480H-483H Keyboard Data Area =~ 
48BH-496H Diskette/Hard Disc Data Area | 
498H-504H System Data and Flags 

SOSH-5SFFH Reserved 
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2.4.2 EX-BIOS Data Structures 


Data structures for the EX-BIOS drivers are located in a block of memory at the top of system 
RAM. The address of this block varies depending on the amount of RAM contained in the system 
and the hardware configuration. 


There are three types of data structures in the EX-BIOS data area. These structures are: 
the HPbrVECTOR_TABLE and its associated HP__ENTRY__CODE, the driver data areas, and the 
EX-BIOS global data area. 


HP_VECTOR_ TABLE 


Each of the 80286 interrupt vectors contains the Code Segment (CS) and Instruction Pointer (IP) 
of Its associated service routine. The HP__ENTRY interrupt vector (O6FH) contains the CS:IP of the 
HP__ENTRY__CODE. This routine uses the value contained in the BP register (an offset into the 
HP__VECTOR__TABLE, vector address) to branch to the appropriate EX-BIOS driver. The 
HP__VECTOR__TABLE resides at the base of the EX-BIOS data area. The HP__VECTOR__TABLE 
consists of an array of 3-word (six bytes) entries, one for each EX-BIOS driver. Each entry consists 
of the IP, CS, and Data Segment (DS) of a driver. 


Figure 2.2 illustrates the relationship between the 80286 interrupt vectors, the 
HP__VECTOR__TABLE, HP__ENTRY__CODE, and the EX-BIOS drivers. 


HP_ENTRY__CODE 


The CS:IP in the HP__ENTRY interrupt vector points to a piece of code which branches to the 
desired EX-BIOS driver. The vector address passed in BP must be a multiple of six. The code is as 
follows: 


HP__ENTRY__CODE: 
MOV DS,CS:[BP + 4] 
JMP FAR PTR CS:[BP] 


This code resides directly after the last entry in the HP__VECTOR_TABLE. Therefore, the CS:IP 


entry in the HP__ENTRY interrupt vector provides two further pieces of information. CS:0 is the 
starting address of the HP__VECTOR__TABLE and IP is the length of the HP__VECTOR__TABLE. 
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Interrupt Vectors and HP_VECTOR_ TABLE 


STD-BIOS 


DRIVER 


INTERRUPT HP_VECTOR_ 
VECTORS TABLE EX-BIOS DRIVER 
INT OH 
IP IP 
| cs 
oS DS EX-BIOS 
DRIVER 
CS cs s 
9 DS O 
a 
IP IP 
CS os, 


INT O6FH 


HP_.HEADER 


EX-BIOS 


INT OFFH DRIVER 


DATA 
AREA 


HP_ENTRY 
CODE 


CS 


fi ; 
oop) 
| a 


Figure 2.2 
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Driver Data Areas 


Each driver has an independently specified data area. Some EX-BIOS drivers share the same data 

areas. The data areas for the EX-BIOS drivers are above the HP__VECTOR__TABLE and the 

HP__ENTRY__CODE shown in figure 2.2. Although each driver has its own data area, the DS for 

each driver is stored in the HP__VECTOR_TABLE, and its data area must start at DS:0. Each data 
e area must reside on a paragraph boundary. 


The data area for each driver consists of a driver header, followed by an optional variable storage 
area. The variable storage area is unique to each driver. Table 2.5 provides a general description 
of the contents of an EX-BIOS driver header. 


Each driver's header and/or variable storage area is described in a following section. 


Table 2.5 
HP_DRIVER_HEADER 


Offset Type Offset Definition 


DH__ATR 0 Word Driver Attribute Field 
a DH__-NAME__INDEX 2 Word Driver String Index Field 
DH__V__DEFAULT 4 Word Driver's Default Logical Device Vector 
DH__P__CLASS 6 Word Driver's Parent Class 
DH__C__ CLASS 8 Word Driver's Child Class 
DH__V__ PARENT OAH Word Driver's Parent Vector 
DH__V__ CHILD OCH Word Driver's Child Vector 
DH__MAJOR OEH Byte Sub Address Field 


DH__MINOR OFH Byte Sub Address Field 


EX-BIOS Driver Headers 


The definition of each of these fields is listed in the following. Additional information on these 
fields can be found in Appendix G. 


e DH__ATR: Each bit in the DH__ATR field indicates a property of the 
driver for device mapping purposes. These bits are 
defined in Appendix G. 
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DH__NAME__INDEX: The DH__NAME__INDEX is used to derive the 
localization string index of the driver. This is given by the 
function F_STR__GET__STRING in the V__SYSTEM 
driver. See Section 9 for additional information. 


DH__V__ DEFAULT: The DH__V__DEFAULT field contains the driver's default =~ 
vector address. | 


DH__P__CLASS and DH__C__CLASS: In conjunction, these fields indicate which drivers may be 
mapped together. DH__P__CLASS and DH__C__CLASS 
are bit masks. Each bit position represents a set of 
drivers. If a bit is set then the driver is in that set of 
drivers. The DH__P__CLASS field indicates a driver is in 
from 0 to 16 different driver sets. A driver can only map 
to another driver if its DH__P__CLASS field matches at 
least one bit position of the other driver's 
DH__C__CLASS field. Furthermore, the DH__ATR field is 
another condition of mapping. The bits are defined in 
Appendix G. 


DH__V__PARENT: The DH__V__PARENT field contains a vector to the driver 
that is called when the current driver receives an F__ISR 
function code that it cannot or doesn't know how to i | 
process. | 


DH__V__CHILD: The DH__V__CHILD field contains a vector to the driver 
that is called if this driver decides it cannot handle the 
request function (as long as that function is not F__ISR). 


DH__MAJOR and DH__MINOR: Device bus address information. 


EX-BIOS Global Data Area 


The method for locating the EX-BIOS global data area is found in the ‘’EX-BIOS Data Area Map’”’ 

of Appendix B. The EX-BIOS global data area is shared between several EX-BIOS drivers. It 

contains temporary and permanent variables that are required by the BIOS to function properly. 

Some of these variables can be modified by application programs. As with any modification to 

the STD-BIOS data area, care should be taken with the EX-BIOS global data area. Table 2.6 

defines the contents of this area. | 
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Table 2.6 
Global Data Area 


Type Definition 


OO-O013H Reserved 
14 T__SND__FLAG Byte Sound Driver Status 


Definition 
‘1° Click enabled 


‘1’ Beep enabled 
5-0 Reserved 


T__SND__CLICK__COUNT Contains number of pending key 
clicks. Maximum of four. 

T__SND__CLICK__. DURA Contains current tick duration 
Scaler. 

T__SND__CLICK__VOLUME Contains current key click volume. 


T__SND__BEEP__CYCLE Contains current beep period in 
ten microsecond increments. 

T__SND__BEEP__DURA Contains current duration of the 
beep in 10 microsecond 
increments. 

T__SND__BEEP__COUNT Contains number of pending beep 
functions. Maximum of four. 

Reserved 

T__STR__NEXT__INDEX Next unused string index number. 

20 andup Reserved 
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SECTION 3. VIDEO 


The HP MultiMode Video Display Adapter provides a wide variety of display modes, resolution, 
character attributes, and other features. The purpose of the video driver is to allow programs to 
access these features and control the video display. 


3.1 Overview 


In the text mode, the MultiMode Video Display Adapter uses an 8 x 16 character cell which 
generates high quality characters. Access to the display memory is fully synchronized to eliminate 
the “snow” problem present in many color display adapters. (Snow occurs when writing a 
character to display memory while the video memory is being accessed by the display refresh 
circuitry.) This full synchronization makes the INT 10H video driver faster, since there is no need 
to wait for a vertical retrace to place characters on the screen. 


The MultiMode Video Display Adapter provides seven more display modes than the industry 
standard color graphics adapter. Four of the modes allow 27 lines of text on the screen. The 
other three modes allow graphics modes that double the graphics resolution of the display 

(320 x 400 and 640 x 400 pixels). The standard INT 10H video driver has been extended to allow 
the programmer to set these modes. No other support is provided to make use of these modes. 
Refer to HP Vectra Technical Reference Manual Volume |: Hardware for more information on the 
MultiMode Video Display Adapter. 


3.2 Data Structures 


The MultiMode Video Display Adapter has 32KB of video memory starting at address OB8000H. 
This allows graphics resolutions of 320 x 400 in medium resolution modes and 640 x 400 in 
high resolution modes. The following is a discussion of how this memory is organized depending 
on the video mode selected. 
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In either of the text modes (80 x 25 or 40 x 25) memory is organized as sequential pages. Each 
page contains character cells that are made up of an 8 bit character code and an 8 bit attribute 
(see Figure 3.1). 


Text Display Memory Organization 


Character Cell Organization Color Values 


Byte 0 Byte 1 


| RGB 
8 Bit Char Code 00 0 0 Black 
000 1 Blue 
00 1 0 
Blink bit 0011 ei 
1 = Blinking on 0100 Red 
0 = Blinking off 0101 Magenta 
O 1 1 0 Brown 
Background color 0o111 Light Grey 
ae 100 0 Dark Grey 
Intensity bit 100 1 Light Blue 
1 = High 101 0 Light Green 
O = Low 1011 Light Cyan 
110 0 Light Red 
Foreground color 110 1 Light Magenta 
11 £71 «0 Yellow 
1. 4 White 
80 x 25 Text Memory Page 
Cell 0 Cell 1 Cell 79 
pageo [ByieOsyet] «| Se COdSC*~*~<“‘“*~*drtCRWO 
(0B800:0H) Row 1 


Row 24 


Paget | TT tte Row 


(0B800:0FA0H) Row 1 


Figure 3.1 


Graphics modes can be of two types: medium resolution (320 x 200 or 320 x 400) and high 
resolution (640 x 200 or 640 x 400). In the medium resolution mode each pixel corresponds to 
two bits of memory so four colors can be displayed. In the high resolution modes each pixel 
corresponds to one bit of memory and only one color can be displayed (the background color is 
always black). See Figures 3.2 and 3.3 for more details. 
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Graphics Display Memory Organization 


320 x 200 Graphics Display Memory 


S li 
CSC 
a | 
aan aemNRaNeEreS Nar 

5 


0B800:4000H 


Writing to these addresses 
actually writes to addresses 
0B800:0H through 0B800:3FFFH 


Not Accessible 


0B800:7FFFH 


Byte / Pixel Organization 


765 43 2 1 0 bit number 


pixel number 


- 1 of 16 Background Colors 


- Red/Magenta 


00 

0 1 - Green/Cyan 

10 

1 1 - Brown/Light Grey 


Figure 3.2 
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Graphics Display Memory Organization 


640 x 400 Graphics Display Memory 


Scan line 
ee ee 
tl | 
eee ee 
fe. ] 
ee ee: 

7 
11 


Byte / Pixel Organization 
7 6 5 43 2 1 «+0 bit number 


0123 45 6 7 pixel number 


- Background Color (Black) 
1-1 of 16 Foreground Colors 


Figure 3.3 
In all the graphics modes, the memory used for scan lines is not sequential but it is interleaved at 
fixed intervals of 8K. In the modes that are 200 scan lines, even scan lines start at offset O and 


odd scan lines start at offset 2000H. In the modes that are 400 scan lines, the following table 
can be used to determine the appropriate offset: 
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| 


Scan line is multiple of 4 (0,4,8,12 ...) use offset 0 

Scan line is multiple of 4 plus 1 (1,5,9,13 ...) use offset 2000H 
Scan line is multiple of 4 plus 2  (2,6,10,14...) use offset 4000H 
Scan line is multiple of 4 plus 3 (3,7,11,15...) use offset 6000H 


All the scan lines of a particular group are organized sequentially within a particular offset. See 
Figures 3.2 and 3.3. 


Other video driver data structures are located in the STD-BIOS data area. They are stored in 


memory addresses 449H (40H:49H) through 466H (40H:66H). Table 3.1 lists the memory 
locations and their definitions. 


Table 3.1 
STD-BIOS Video Driver Data Area 


Address 


00449H 
O044AH 
OO44CH 
O044EH 
00450H 


00452H 
00454H 
00456H 


00458H 
OO45AH 


OO45CH 
OO45EH 
00460H 
00462H 
00463H 


00465H 
00466H 


Type 
Byte 

Word 
Word 
Word 
Word 


Word 
Word 
Word 
Word 
Word 


Word 
Word 
Word 
Byte 
Word 
Byte 
Byte 


Definition 


Current Video Display Mode 
Number of columns 

Regen buffer length 

Starting address of regen buffer 
Cursor position for Display Page 0 


Cursor position for Display Page 1 
Cursor position for Display Page 2 
Cursor position for Display Page 3 
Cursor position for Display Page 4 
Cursor position for Display Page 5 


Cursor position for Display Page 6 
Cursor position for Display Page 7 
Current cursor mode 
Active page number 
Address of current display adapter 


Mode (current setting of status register) 
Pallet setting 


Video data structures are also maintained in the EX-BIOS data area. These structures are 
accessible through the data segment of the EX-BIOS video service routine. The following code 
sets the ES register to the EX-BIOS video driver's (V__SVIDEO’S) data segment: 
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MOV Ax,0 /segment at O 


MOV ES,AX ; 
MOV AX,ES: [6FH*4 + 2] fread the base address 
jof the HP__VECTOR__TABLE 
MOV ES,AX 
MOV AX,ES: [V_SVIDEO +4] _ ;read base address of 
MOV ES,AX ‘video parameters 


The addresses listed are offsets into this data segment. The following table gives the data 
maintained in V__SVIDEO’s (0054H) data segment: 


Table 3.2 


Video EX-BIOS Data Structures 


Variable Name Offset 


Type Definition 
Byte Device Header Attributes, Name, Index, 
and Default Vector 
VID__PRIMARY 6 Byte The current primary display: 
00 Card at I/O Address 3BOH 
01 Card at I/O Address 3COH 
02 Card at I/O Address 3D0H 
03 Card containing ROM Code. 
VID__SECONDARY ( Byte If two cards are in the system, same 
number as VID__PRIMARY for the 
second card. 
VID__FOUND__ROM 8 Byte Flag set to true if ROM code was found 


Driver Header 


in any video adapter card. 
VID__IDS 9-OCH Byte List of IDs of all cards found. 
VID__STATUS OD-010H Byte RAMcopies of the status register. 
VID__EXT__STATUS 11-014H Byte RAM copies of the extended status 
register for each possible card in the 
system. 
VID__PARM__BLOCK 15-O3BH Byte Reserved for saving the video 


parameters stored in the standard BIOS 
data area when switching between 
primary and secondary video boards. 
VID__LAST__IBM__MODE O3CH Byte Used to detect if a ‘rogue’ program 
changed the modes without telling the 
HP system. 
VID__EXT__MODE Q3DH Byte Specifies the current video mode 
). 


(O...15 
3E-O3FH Byte Reserved 
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3.3 Video Driver (INT 10H) 


The video driver functions can be broken down into the following categories. 


@® Display Control—These functions control the display appearance, cursor and light pen 
position, active text memory page, and scrolling through text memory. 


® Character Handling Functions—These functions manipulate characters on the screen. 
@ String Functions—These functions allow placement of strings of text on the screen. 


@® Graphics Functions—These functions provide a minimal interface to the graphics capabilities 
of the machine. 


@ Extended Video Functions—These functions support extra video capabilities of the 
MultiMode Video Display Adapter hardware. 


Table 3.3 summarizes the functions performed by the video driver. A detailed description of the 
functions is given following the table. 
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Table 3.3 


Video Driver Function Code Summary 


INT Function/ 
Hex Equate 


10H INT__VIDEO 
F1Q__SET__MODE 
F10__SET__CURSIZE 
F10__SET__CURPOS 
F10__.RD__CURPOS 
F10__RD__PENPOS 


F10__SET__PAGE 

F10__ SCROLL__UP 
F10__SCROLL__DN 
F10__RD__CHARATR 


F10__WR__CHARATR 


F1O0_.WR__CHARCUR 
F1Q__SET__ PALLET 
F1O__WR__PIXEL 
F1O__RD__ PIXEL 
F1O_.WR__CHARTEL 
F10__GET__STMODE 


Write string functions: 
F10__WRS__00 
F10__WRS__01 
F1O0__WRS__02 
F10__WRS__03 


F10__INQUIRE 
F10__GET__INFO 
F1Q__SET__INFO 
F10_.MOD__INFO 
F1O__GET__RES 
F10__XSET__MODE 
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Function 
Value 


OOH 
O1H 
O2H 
O3H 
O4H 


OOH 


OAH 
OBH 
OCH 
ODH 
OEH 
OFH 
10H-12H 


Definition 


Video 

Set video mode 

Set cursor size 

Set cursor position 

Read cursor position 

Read light-pen position 

Set active display page 

Scroll rectangle up 

Scroll rectangle down 

Read character and attribute at cursor 
position 

Write character and attribute at cursor 
position 

Write character at cursor position 

Set color pallet 

Write pixel 

Read pixel 

Write teletype character 

Get video state and mode 

Reserved 


global attribute 

global attribute, move cursor 
individual attributes 

individual attributes, move cursor 


EX-BIOS present 

Get video parameters 

Sets video parameter 
Modifies video parameters 
Reports video resolution 
Sets video resolution 


Video Driver Function Definitions 


The following function definitions provide a detailed description of each of the functions in the 
video driver. 


F10_SET_MODE (AH = OOH) 

This function sets the display mode of the video adapter. The new mode is determined by the 
value passed in the AL register. Refer to the Vectra Technical Reference Manual, Volume | for 
additional information on the various video display modes available on the MultiMode Video 


Display Adapter. 


On Entry: AH = F10__SET__MODE (00H) 
AL = Mode 


Data Definition 


00 40 x 25 Black and White Alphanumeric 

01 40 x 25 Color Alphanumeric 

02 80 x 25 Black and White Alphanumeric 

03 80 xX 25 Color Alphanumeric 

04 320 x 200 Color Graphics 

05 320 x 200 Black and White Graphics 

06 640 x 200 Black and White Graphics 

07 Only valid if a monochrome display adapter is present. 


On Exit: | No values returned 


Registers Altered: AX 


F10__SET__CURSIZE (AH = 01H) 


This function sets the size of the cursor displayed in the alphanumeric display modes. Each 
character cell in the alphanumeric display modes is eight scan lines high. The cursor size is 
defined by specifying the starting and ending scan lines within the character cell. The scan lines 
are numbered from 0 (top of cell) to 7 (bottom). The starting and ending scan lines are passed in 
registers CH and CL. This function performs no operation if the MultiMode Video Display 
Adapter is in one of the graphics modes. 


On Entry: AH = F10__SET__CURSIZE (01H) 
CH = Starting scan line 
CL = Ending scan line 


Video 35 


On Exit: | No values returned. 


Registers Altered: AH 


F10_SET_CURPOS (AH = 02H) 


This function sets the row and column address of the cursor to the specified page, and moves 
the cursor to that address. When the MultiMode Video Display Adapter is in one of the graphics 
modes, a page number of 0 must be specified. 


On Entry: AH = F10__SET__CURPOS (02H) 
BH = Display page number 
DH = Row address of cursor. (0. . .24) 
DL = Column adaress of cursor. (0. . .79) 


On Exit: | No values returned. 


Registers Altered: None 


F10_RD_.CURPOS (AH = 03H) 


This function returns the current address and size of the cursor on the specified page. If the 
MultiMode Video Display Adapter is in one of the graphics modes, a page number of 0 must be 
specified. The values returned for the cursor size in the graphics mode will be invalid. 


On Entry: AH = F10__RD__CURPOS (03h) 
BH = Display page number 


On Exit: CH = Starting scan line 
= Ending scan line 
DH = Row address of cursor. (0. . .24) 
= Column address of cursor. (0. . .79) 


Registers Altered: CX, DX 


F10_.RD__PENPOS (AH = 04H) 


This function returns the current state and position of the light pen if it is activated. The position 
is reported in both character row/column and graphic pixel formats. 


On Entry: AH = F10__RD__PENPOS (04H) 
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On Exit: AH = Light Pen state 


Data Definition 
O Not activated 


1 Activated 
BX = Horizontal pixel position of light pen 
CH = Vertical pixel position of light pen (200 line mode) 
DH = Row position of light pen 
DL = Column position of light pen 


Registers Altered: AH, BX, CH, DX 


F10_ SET_ PAGE (AH = 05H) 


This function sets the active display page in the alphanumeric mode. Valid page numbers are 0 
through 7 for 80 x 25 modes, and 0 through 7 for 40 x 25 modes. This function is not valid 
for graphics modes. 


On Entry: AH 
AL 


F10__SET__PAGE (05h) 
Page number (0 through 7) 


On Exit: No values returned. 


Registers Altered: AX 


F10_SCROLL_UP (AH = 06H) 


This function scrolls the contents of a window up a specified number of lines. The window is 
defined by the row and column addresses stored in the CX and DX registers. The number of lines 
to be scrolled is passed in register AL. If AL is set to 0, the function interprets this as a command 
to scroll all lines. 


On Entry: AH = F10__SCROLL__UP (06H) 
AL = Number of lines to scroll (O = scroll all) 
BH = Attribute to place in blanked lines 
CH = Row adaress of upper left corner of window (0. . .24) 
CL = Column address of upper left corner of window (0. . .79) 
DH = Row address of lower right corner of window (0. . .24) 
DL = Column adaress of lower right corner of window (0. . .79) 
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On Exit: | No values returned. 


Registers Altered: None 


F10_SCROLL_DN (AH = 07H) 


This function scrolls the contents of a window down a specified number of lines. The window is 
defined by the row and column addresses stored in the CX and DX registers. The number of lines 
to be scrolled is passed in register AL. If AL is set to 0, the function interprets this as a command 
to scroll all lines. This function is only valid when the MultiMode Video Display Adapter is in one 
of the alphanumeric modes. 


On Entry: AH = F10__SCROLL__DN (07H) 
AL = Number of lines to scroll (0 = scroll all) 
BH = Attribute to place in blanked lines; 
CH = Row adaress of upper left corner of window (0. . .24) 
CL = Column address of upper left corner of window (0. . .79) 
DH = Row address of lower right corner of window (0. . .24) 
DL = Column address of lower right corner of window (0. . .79) 


On Exit: | No values returned. 


Registers Altered: None 


F10_.RD__CHARATR (AH = 08H) 


This function returns the character byte and attribute byte at the current cursor location. If the 
MultiMode Video Display Adapter is in one of the alphanumeric modes, a page number must be 
specified. If the video display adapter is in one of the graphics modes, only the character is 
returned, since characters do not have attribute bytes in the graphics modes. 


On Entry: AH = F10__RD__CHARATR (08H) 
BH = Page number (alphanumeric modes only) 

On Exit: AH = Attribute byte (valid only in alphanumeric modes) 
AL = Character 


Registers Altered: AX 
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F10_WR_CHARATR (AH = 09H) 


This function writes character and attribute bytes at the current cursor location. If the MultiMode 
Video Display Adapter is in one of the alphanumeric modes, a page number may be specified. If 
the MultiMode Video Display Adapter is in one of the graphics modes, only the character is 
written. More than one character and attribute can be stored by placing the number of copies 
desired in CX. This function will wrap around both line and screen if too many characters are 
specified. Note that this function makes copies of a single character/attribute combination, it 
does not print a string. Refer to the Write String function for that operation. 


On Entry: AH = F10__WR__CHARATR (09H) 
AL = Character 
BH = Page number (alphanumeric modes only) 
BL = Attribute byte (valid only in alphanumeric modes) 
CX = Number of characters to write 


On Exit: | No values returned. 


Registers Altered: None 


F10_WR_CHARCUR (AH = OAH) 


This function writes a character to the current cursor location, retaining the existing attribute 
byte. The function is identical to the F10__WR__CHARATR function, except that no attribute 
byte is written. 


On Entry: AH = F10__WR__CHARCUR (OAH) 
AL = Character 
BH = Page number (alphanumeric modes only) 
CX = Number of characters to write 


On Exit: | No values returned. 


Registers Altered: None 
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F10_ SET_PALLET (AH = OBH) 


This function allows setting the background color (if BH = OQ) or the foreground color pallet 
(if BH = 1). 


On Entry: AH 
BH 


F10__SET__PALLET (OBH) 
Color Select ID 


Data Definition 


0 Set the background color (in medium resolution modes) or the 
foreground color (in high resolution modes) based on the low bits of BL 
(bits 0. . .3) to one of 16 colors. 


1 Select color pallet (for medium resolution modes) based on the least 
significant bit of BL. If-bit O of BL = ‘0’ then select the green, red, brown 
pallet. If bit of BL = ‘1° then select the cyan, magenta, light grey pallet. 

BL = Color select value 


On Exit: No values returned 


Registers Altered: None 


F10_WR_ PIXEL (AH = OCH) 


This function writes a pixel on the screen. If the MultiMode Video Display Adapter is in one of 
the ‘Four color’’ modes (320 x 200) the color of the pixel may be passed in register AL. Bits 0 
and 1 of AL are interpreted as the color bits. If bit 7 of AL is set, bits O and 1 are "XOR’ed with 
the current pixel color bits, otherwise they replace the current pixel color bits. If the MultiMode 
Video Display Adapter is in the ‘Two color’ mode (640 x 200), the bit corresponding to the 
desired pixel is set. 
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On Entry: 


On Exit: 


AH = F10__WR__PIXEL (OCH) 
AL = Color 


In “Four color’’ mode (320x200): 


Bit Data Definition 


71 Bits O and 1 XORed with current pixel. 
0 Bits O and 1 replace current pixel. 
0,1 Color bits. 


In “Two color’’ mode (640 x 200): 


Bit Data Definition 


71 Bit O XORed with current pixel. 
0 Bit O replaces current pixel. 
0 Color bit. 


CX = Horizontal pixel address 
DX = Vertical pixel address 


No values returned. 


Registers Altered: AX 


F10_.RD__PIXEL (AH = ODH) 


This function returns the color code of the specified pixel. 


On Entry: 


On Exit: 


AH = F10__RD__PIXEL (ODH) 
CX = Horizontal pixel address 
DX = Vertical pixel address 
AL = Color value of pixel 


Registers Altered: AX, CX, DX 
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F10_WR_CHARTEL (AH = OEH) 


This function writes a character to the active page, then advances the cursor one location. At the 


end of a line, the cursor will wrap to the next line; at the end of the screen, the cursor will scroll. 
In the alphanumeric modes, this function maintains the current video display attributes. In the 
graphics modes, the foreground color is passed in register BL. The ASCII characters Line Feed 


(OAH), Carriage Return (ODH), Backspace (08H), and Bell (07H) are interpreted by this function as 


ASCIl commands and are executed as such. 


On Entry: AH = F10__WR__CHARTEL (OEH) 
AL = Character 
BL = Foreground color (in graphics modes only) 


On Exit: | No values returned. 


Registers Altered: AX 


F10__GET_STMODE (AH = OFH) 


This function returns the current MultiMode Video Display Adapter state. The mode, number of 
characters per line, and current display page are returned. 


On Entry: AH = F10__GET__STMODE (OFH) 
On Exit: © AH = Number of characters per line 
AL = Current mode 
BH = Current display page 


Registers Altered: AX, BH 


Write String (AH = 13H) 

This function writes a string of characters to the screen. This function consists of four separate 
subfunctions which control whether each character has its own attribute byte or not, and 
whether the cursor is moved or not. Each of the subfunctions is detailed in the following. The 
ASCII characters Line Feed (OAH), Carriage Return (ODH), Backspace (08H), and Bell (07H) are 
interpreted by this function as ASCII commands and are executed as such. 


F10_WRS__00 (AX = 1300H) 


Write string attribute without moving cursor. 
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On Entry: AX = F10__WRS__00 (1300H) 
BH = Display page number 
BL = String attribute byte 
CX = Length of string 
DH = Row address of first character 
DL = Column address of first character 
ES:BP = Pointer to start of string 


Format of string is: 
Char, Char, ..., Char 


On Exit: | No values returned. 


Registers Altered: None 


F10_WRS_01 (AX = 1301H) 


Write string attribute and move cursor. 


On Entry: AX = F10__WRS__01 (1301H) 
BH = Display page number 
BL = String attribute byte 
CX = Length of string 
DH = Row adaress of first character 
DL = Column address of first character 
ES:BP = Pointer to start of string 


Format of string Is: 
Char, Char, .. ., Char 


On Exit: | No values returned. 


Registers Altered: None 


F10_ WRS_02 (AX = 1302H) 


Write character attribute without moving cursor. 
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On Entry: AX = F10_WRS_ 02 (1302H) 


BH = Display page number 

BL = String attribute byte 

CX = Length of string 

DH = Row adaress of first character 

DL = Column adaress of first character ~ 
ES:BP = Pointer to start of string 


Format of string Is: 
Char, Attr, Char, Attr, .. ., Char, Attr 


On Exit: No values returned. 


Registers Altered: None 


F10_WRS_03 (AX = 1303H) 


Write character attribute and move cursor. 


On Entry. AX = F10__WRS__03 (1303H) 
BH = Display page number 
CX = Length of string 
DH = Row address of first character im | 
DL = Column address of first character 
ES:BP = Pointer to start of string 


Format of string Is: 
Char, Attr, Char, Attr, ..., Char, Attr 


On Exit: | No values returned. 


Registers Altered: None 


3.4 HP Video Extension Functions 


This set of functions support the features of the MultiMode Video Display Adapter which are not “<™@™y 
covered using the standard video functions. This function consists of separate subfunctions | 
which support the various extended capabilities of the MultiMode Video Display Adapter. Each 

of these subfunctions is defined in the following subsections. 
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F10__ INQUIRE (AX = 6FOOH) 


This subfunction determines whether or not the extended HP functions are available. If the 
extended video functions are available, the BX register will be set to 4850H (which is the ASCII 
characters ‘HP’). 


On Entry: AX = F10__INQUIRE (6FOOH) 
BX = Any value except 4850H (‘HP’) 
On Exit: BX = ‘HP’ (4850H) 


Registers Altered: AX, BX 


F10_GET_INFO (AX = 6F01H) 

This function returns information about the primary display adapter. 
On Entry: AX = F10__GET__INFO (6F01H) 

On Exit: AH = Status register information 


Bit Data Definition 


1 Display Enabled. 
1 Light Pen Trigger Set. 
1 Light Pen Switch Made. 
] Vertical Synchronization 

Monitor Resolution 

350 or 400 line monitor 
1 200 line monitor 
5 Display type 

Color 
1 Monochrome 

6-7 Diagnostic Bits 


hWN- © 
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AL = Card Identifier 


Data 
OOH 
41H 
42H 
43H 
44H 
45H 
46H 
51H 


Definition 

Non HP card with ROM and possibly its own INT 10H driver. 
MultiMode Video Display Adapter 

Reserved 

Reserved 

Reserved 

Industry Standard Monochrome Display Adapter 

Industry Standard Color Display Adapter 

Reserved 


CL = Current value of Extended Control register. This register is only valid when the 
Card Identifier is 41H. 


This description applies to data returned when a MultiMode Video Display Adapter is in the 


system. 


Bit Data Definition 


0 


6-7 


0 
1 


0 
1 


0 


— 


— 


Current screen resolution 

200 line 

400 line 

Underline enable. 

‘Blue’ bit of foreground attribute interpreted as color blue. 
‘Blue’ bit of foreground attribute interpreted as underline. 
Font Selected. 

Standard-8 

HP-ROMAN-8 

Memory disable. 

Memory enabled for CPU access. 

Memory disabled for CPU access. 

16/32K Memory select. 

Wrap second 16K of RAM into first 16K. 

Allow access to full 32K of memory. 

Page select. 

Select first 16K of memory. 

Select second 16K of memory. 

Unused 


Registers Altered: AX, CL 
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F10_SET_INFO (AX = 6F02H) 

This function modifies the value of the Extended Control register port 3DDH on the MultiMode 
Video Display Adapter. (Refer to the Vectra Technical Reference Manual, Volume | for more 
information about this port.) 


On Entry: AX = F10__SET__INFO (6F02H) 


BL Byte of data to be written to the Extended Control Register. 
Bit Data Definition 
0 Current screen resolution 
0 200 line 
1 400 line 
1 Underline enable. 
0 ‘Blue’ bit of foreground attribute interpreted as color blue. 
1 ‘Blue’ bit of foreground attribute interpreted as underline. 
2 Font Selected. 
0 Standard-8 
1 HP-ROMAN-8 
3 Memory disable. 
0 Memory enabled for CPU access. 
1 Memory disabled for CPU access. 
4 16/32K Memory select. 


0 Wrap second 16K of RAM into first 16K. 
Allow access to full 32K of memory. 


—’ 


5 Page select. 

0 Select first 16K of memory. 

1 Select second 16K of memory. 
6-7 Reserved 


On Exit: No values returned. 


Registers Altered: AX, BL 


F10_MOD_INFO (AX = 6F03H) 
This function modifies individual bits in the Extension Control register (port 3DDH) of the Multi- 


Mode Video Display Adapter. A mask byte is passed in register BH, which allows individual bits to 
be modified without changing the state of other mode bits in the register. 
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On Entry: AX = F10__MOD__INFO (6F03H) 
BH = Mask. Bits with a mask value of ‘1’ are not modified; bits with a mask value of 
‘O' are modified. 
BL = Bits to change. The bits indicated by the mask (BH) take the value of the BL 


register. ~ 
Bit Data Definition 
0 Current screen resolution 
0 200 line 
1 400 line 
1 Underline enable. 
‘Blue’ bit of foreground attribute interpreted as color blue. 
1 ‘Blue’ bit of foreground attribute interpreted as underline. 
2 Font Selected. 
0 Standard-8 
1 HP-ROMAN-8 
3 Memory disable. 
0 Memory enabled for CPU access. 
1 Memory disabled for CPU access. 
4 16/32K Memory select. 
0 Wrap second 16K of RAM into first 16K. 
1 Allow access to full 32K of memory. -~ 
5 Page select. | 
Select first 16K of memory. 
1 Select second 16K of memory. 
6-7 Reserved 
On Exit: | No values returned. 
Registers Altered: AX 
Example: 
MOV AX,F10_.MOD__INFO _ ; EX-BIOS Function Modify 
; Ex-Reg (6FO3H) 
MOV BL,OO000100B , Select Character Font: HP-PROMAN-8 
MOV BH,11111011B ; Only Modify Character Font 
INT 10H ; Call Video Interrupt ~ 


F10__GET_RES (AX = 6F04H) 


This function returns the current video mode and screen resolution. 
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On Entry: AX = F10__GET_RES (6F04H) 
On Exit: AL = Current video mode (See Set Mode.) 


Data Definition 
OOH 40 x 25 Alphanumeric Black and White 


01H 40 x 25 Alphanumeric Color 

02H 80 X 25 Alphanumeric Black and White 
03H 80 x 25 Alphanumeric Color 

04H 320 X 200 Graphics Color 

O5H 320 X 200 Graphics Black and White 

O6H 640 x 200 Graphics Black and White 

07H 80 X 25 Only Valid for Monochrome Cards 
08H 80 x 27 Alphanumeric Black and White 
O9H 80 x 27 Alphanumeric Color 

OAH 40 x 27 Alphanumeric Black and White 


OBH 40 x 27 Alphanumeric Color 

OCH Reserved 

ODH 640 x 400 Graphics Black and White 
OEH 320 x 400 Graphics Color 

OFH 320 x 400 Graphics Black and White 


If in one of the graphics modes: 


BX 
CX 


Horizontal resolution in pixels 
Vertical resolution in pixels 


If in one of the text modes: 


BX 
CX 


Number of characters per row 
Number of rows 


Registers Altered: AX, BX, CX 


F10__XSET_MODE (AX = 6F05H) 


This function places the MultiMode Video Display Adapter in one of sixteen possible modes of 
operation. Modes 0 through 7 are identical to the modes available with function 
F10__SET__MODE of the video driver. Modes 8 through 15 are unique to the HP Vectra and its 
MultiMode Video Display Adapter, and may only be set using this function. 


Video 49 


Programmers must exercise caution when setting video modes with both F10__SET__MODE (0H) 
and F10__XSET__MODE (6FO5H). Whenever F10__XSET__MODE is used to select one of the ‘HP 
only’ modes (8-15), F10__XSET__MODE (not F10__SET__MODE) must be used to return to one 
of the industry standard modes (0-7). This ‘‘pairing’’ of function calls is necessary because 
F10__XSET__MODE modifies an I/O port not normally affected by the industry standard modes. 
F10__SET__MODE does not deal with this I/O port. 


On Entry: AX = F10__XSET__MODE (6FO5H) 
BL = Video mode 


Data Definition 


OOH 40 x 25 Alphanumeric Black and White 
O1H 40 X* 25 Alphanumeric Color 

02H 80 x 25 Alphanumeric Black and White 
03H 80 x 25 Alphanumeric Color 

04H 320 x 200 Graphics Color 

OSH 320 x 200 Graphics Black and White 

O6H 640 x 200 Graphics Black and White 

07H 80 x 25 Only Valid for Monochrome Cards 
08H 80 X 27 Alphanumeric Black and White 
O9H 80 x 27 Alphanumeric Color 

OAH 40 x 27 Alphanumeric Black and White 
OBH 40 x 27 Alphanumeric Color 


OCH Reserved 
ODH 640 x 400 Graphics Black and White 
OEH 320 xX 400 Graphics Color 
OFH 320 X 400 Graphics Black and White 
On Exit: No values returned. 
Altered Registers: AX, BL 


Example: 


MOV AX,FIO_XSET_MODE _ ; Call EX-BIOS function 


; Set mode (6FO5H) 
MOV BL,ODH ; Select 640 x 400 line mode 
INT  INT__VIDEO ; Call video interrupt (10H) 


50 Video 


SECTION 4 


~ Table of Contents 
4. INPUT SYSTEM and HP-HIL.............................. 55 
A.1 OVEr°vieW 2000 c nce c teen ev tntvenerenes 55 
4.2 Application Interface Level...............00 en, 55 
4.2.1 OvervieW «2.000 e nner eeeenenee, 57 
4.2.2 Data Structures... 00... cence es 58 
4.2.2.1 Logical Describe Record.................. 0.0. ene 58 
4.2.2.2 Logical ISR Event Records .....................0 0.0 ccc cece 61 
4.2.2.3 Application Event Drivers .................0 0.0.0 63 
4.2.3 Logical GID Drivers........000.0.0.0. 0.0 cee. 63 
4.2.3.1 V__LTOUCH Driver (BP = OOC6H) .....................0...00.0.0..... 64 
Touch Screen Driver Function Definitions.....................0. 00.00.0002. 65 
F__ISR (AH = OOH).......... 65 
~~ SF__INIT (AX = O200H).......... 65 
| SF__START (AX = 0202H).......... 66 
SF__REPORT__ STATE (AX = 0204H).......... 66 
SF__VERSION__ DESC (AX = O206H).......... 66 
SF__DEF__ATTR (AX = 0208H).......... 67 
SF__GET__ATTR (AX = O20AH).......... 67 
SF__SET__ATTR (AX = 020CH).......... 67 
SF__TRACK__ON (AX = O404H).......... 68 
SF__TRACK__OFF (AX = O406H).......... 68 
SF__CREATE__EVENT (AX = 0408H).......... 68 
SF__EVENT__ON (AX = O40AH).......... 70 
SF__EVENT___OFF (AX = O40CH).......... 71 
SF__CLIPPING__ON (AX = O40EH).......... 71 
SF__CLIPPING__OFF (AX = 0410H).......... 71 
F__ SAMPLE (AH = O6H).......... 72 
4.2.3.2 V__LPOINTER Driver (BP = OOCOH)....................0.0.0..000... 72 
Pointer Driver Function Definitions...................0..0. 00.00.0000... 008: 73 
F__ISR (AH = OOH).......... 73 
SF__INIT (AX = O200H).......... 74 
SF__START (AK = O20 2) ie eee Boaters 75 
SF__REPORT__STATE (AX = 0204H).......... 75 
SF__VERSION__DESC (AX = 0206H).......... 75 
SF__DEF__ATTR (AX = 0208H).......... 76 


SF__GET__ATTR (AX = O20AH).......... 76 
SF__SET__ATTR (AX = O20CH).......... 76 
SF__TRACK__ON (AX = O404H).......... 77 
SF__TRACK___OFF (AX = O406H).......... 77 
SF__CREATE__EVENT (AX = O408H).......... 77 
SF__EVENT__ON (AX = O40AH).......... 79 
SF__EVENT__OFF (AX = O40CH).......... 80 
SF__CLIPPING__ON (AX = O40EH).......... 80 
SF__CLIPPING__OFF (AX = O410H).......... 80 

F_ SAMPLE (AH = O6H).......... 81 
4.2.3.3 V__LTABLET Driver (BP = OOBAH)........................0 00.00... 81 
Tablet Driver Function Definitions.................... 0.00.0... cece 82 
F__ISR (AH = OOH).......... 82 
SF__INIT (AX = 0200H).......... 83 
SF__START (AX = O202 Aico weadh eek 84 
SF__REPORT__STATE (AX = O204H).......... 84 
SF__VERSION__ DESC (AX = O206H).......... 84 
SF__DEF__ATTR (AX = 0208H).......... 85 
SF__GET__ATTR (AX = O20AH).......... 85 
SF__SET__ATTR (AX = 020CH).......... 85 
SF__TRACK__ON (AX = O404H).......... 86 
SF__TRACK__OFF (AX = O406H).......... 86 
SF__CREATE__EVENT (AX = O408H).......... 86 
SF__EVENT__ON (AX = O40AH).......... 88 
SF__EVENT__OFF (AX = O40CH).......... 89 
SF__CLIPPING__ON (AX = O40EH).......... 89 
SF__CLIPPING___OFF (AX = 0410H).......... 89 

F_ SAMPLE (AH = O6H)....:..... 90 
4.2.4 Application Event Driver Example............................. 90 
4.3 Hardware Interface Level... eee. 95 
A381 OVCRMVIIOW. cote eicacce es seen daw he hectic Ie bomen eRe 95 
4.3.1.1 Device Driver Mapping................... 00.00. 97 
4.3.1.2 Device Emulation ............... 0.0.0.0. ccc eens 97 
4.3.2 Data Structures...........00 0. cece 98 
4.3.2.1 Physical Describe Record .................. 0.0... eee eee 98 
4.3.2.2 Physical ISR Event Records ................... 000. eee 100 
4.3.3 Hardware Interface Level Drivers............................. 102 
4.3.3.1 V__S8259 Driver (BP = OO1EH)..................0000000 0002002, 102 
V__$8259 Driver Function Definitions.......................0.0..00....0.00. 103 
F__ISR (AAC 00F is: cae eeces 103 
SF__INIT (AX = 0200H)......... 104 


52 Input System and HP-HIL 


SF__START 
SF__VERSION__ DESC 
SF__ENABLE__SVC 
SF__DISABLE__SVC 
SF__ENABLE__KBD 
SF__DISABLE__KBD 
SF__ENABLE__HPHIL 
SF__DISABLE__HPHIL 

4.3.3.2 V__HPHIL Driver (BP = 0114H) 

V__HPHIL Driver Function Definitions 
F__ISR 
SF__INIT 
SF__REPORT__STATE 
SF__VERSION__ DESC 
SF__OPEN 
SF__CLOSE 
SF__CRV__RECONFIGURE 
SF__CRV__WR__PROMPTS 
SF__CRV__WR__ACK 
SF__CRV__REPEAT 
SF__CRV__DISABLE__ REPEAT 
SF__CRV__SELF__ TEST 
SF__CRV__REPORT__STATUS 
SF__CRV__REPORT__NAME 
SF__KEYBOARD__REPEAT 
SF__KEYBOARD__LED 
F_ PUT__ BYTE 
F__GET__BYTE 
F__PUT__ BUFFER 


4.3.3.3 V__SINPUT Driver (BP = 002AH) 


V__SINPUT Driver Function Definitions 
F__ISR 
SF__INIT 
SF__DEF__LINKS 
SF__GET__LINKS 
SF__SET__LINKS 
F__INQUIRE 
F__INQUIRE__ALL 
F__INQUIRE__FIRST 
F__REPORT__ENTRY 
4.3.3.4 Physical GID Driver 
Physical GID Driver Function Definitions 
F__ISR 
SF__INIT 


5 
Hou MW oa WT al 


SSrors 
SEK RRR 
ITFrTriu i uu yp | 


> 


O202F) a8% acids 104 
02067) ccs can’ 104 
O400H)......... 105 
O402H)......... 105 
O404H)......... 105 
O406H)......... 105 
OA OB) a Sais 2 aed 106 
O40AH)......... 106 
94 010) 7) seen 108 
OZ00F) ite act atoies 108 
O204 A) wet cee var 108 
OZ06A) setae tee 109 
OZQEM) a: dhe ds 109 
OZ VOR). 5 sauce 110 
O406H)......... 110 
O408H)......... 110 
O40AH)......... 111 
O40CH)......... 112 
O40EH)......... 112 
O410H)......... 113 
O0412H)......... 114 
O414H)......... 114 
O416H)......... 115 
0418H)......... 116 
= 08) ep eee eee 116 
= 0|0) 5) ne ee 117 
= OAM) sua 2 5.t5 118 
Mga aac tne od J 119 
= OUR) aati oe ee 120 
OZ QO) ce ctnte atten s 120 
O400H)......... 120 
04024) sa new neks 121 
O404H)......... 122 
= 06s caylee hs 123 
= USF) s sacuaeen 123 
== OAR) si4Go et 124 
SHOGCH) aectess 124 
re eee eT ee 125 
SOOTY gnc'e-s od cet 125 
67/40)6) 5) canna 126 


Input System and HP-HIL 53 


SF__START 


SF__VERSION__DESC 
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4.3.4 Hardware Interface Level Services 
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V__ STRACK Driver Function Definitions 
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SECTION 4. INPUT SYSTEM AND HP-HIL 


The Input System is a set of drivers which support the HP-HIL input devices. Up to seven HP-HIL 
input devices may be connected at one time. The Input System can support properly integrated 
non-HP-HIL devices as well. In its basic configuration, the system has one input device, the 
keyboard. 


4.1 Overview 


The standard devices that connect to the system via the HP-HIL link are the keyboard, mouse, 
touch screen and tablet. The application interface for the keyboard is described in Section 5. The 
industry standard interface for the mouse (INT 33H functions) is provided in Section 6. The 
interfaces for simple mouse, touch screen and tablet support are described in this section. 


The architecture of the Input System is divided into two levels (see figure 4.1). The application 
interface level allows the programmer to communicate with the HP-HIL devices with minimum 
overhead. The second level, the hardware interface level, allows programmers to manipulate the 
internals of the system. With this interface, support for additional devices can be added or the 
data path of existing ones re-directed. 


The first portion of this section provides an overview of the application interface level, a detailed 
description of the actual interfaces and how to access them. The second portion of this section 
describes the hardware interface level. 


4.2 Application Interface Level 


Application programs interface with the Input System through a set of logical device drivers. The 
Input System has an application interface for keyboard, tablet, pointer (simple mouse), and touch 
screen input devices. These drivers are shown in figure 4.1. 
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Input System Block Diagram 
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Figure 4.1 


The tablet, pointer, and touch screen application program interface drivers are grouped together 
in figure 4.1 as they are all Graphic Input Device (GID) drivers. GID drivers accept relative graphic 
motion data, absolute graphics data, and button scancode data from the input devices. Data 
from these devices is represented in a consistent manner throughout the Input System, making 


programmatic access to different Graphic Input Devices a simple task (see the Application Event 
Driver Example later in this section). 
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4.2.1 Overview 


The Input System supports three logical GID drivers; one for each of the standard GID data types. 
There is a GID driver for each of the touch screen, pointer (simple mouse), and tablet devices 
called V__LTOUCH, V__LPOINTER, and V__LTABLET respectively. Each of these drivers has a fixed 
location in the HP_.VECTOR_TABLE. They all share a common code module (i.e., they have the 
same CS:IP in the table), but have different data areas. 


The GID drivers perform clipping and scaling under certain conditions. Absolute devices like the 
touch screen and tablet are always scaled but clipping is user selectable. Relative devices like the 
mouse can have both scaling and clipping selected by the user. 


The logical GID drivers perform two additional tasks. The first is graphics cursor movement (sprite 
tracking). This is performed by the EX-BIOS driver V__STRACK, which is called by the logical GID 
driver if tracking is enabled. The second task is to provide interrupt service to the application. The 
application may install a routine to be called by the logical GID driver every time a GID event 
occurs, as opposed to the application calling the GID driver repeatedly (polling) to see if an event 
has occurred. 


The following text outlines the actions that occur for touch screen input; from touching the 
screen to application data retrieval. 


1. The user touches the screen. This causes the physical device to generate input data and 
interrupt the hardware interface level. 


2. The hardware interface level processes the interrupt and passes the data (ISR Event Record) 
to the logical touch screen driver (V__LTOUCH). 


3. V__LTOUCH scales the event to fit the current dimensions of the screen. At this point two 


optional things may happen. First, the data may be clipped. Second, the user defined event 
driver will be called if it is installed and enabled. 


4. \f the user event routine was not installed and enabled then the application must call (poll) 
V__LTOUCH with the F_SAMPLE function (see subsection on V__LTOUCH functions) to get 
the input data. 


There are two methods for applications to receive data from the Input System: polled mode and 
interrupt mode. In polled mode, the application must continually interrogate the logical GID 
driver using the F_SAMPLE function to determine If any input has occurred, In interrupt mode, 
the application must first install an ISR event handling routine (application event driver) using 
SF__CREATE__EVENT to handle interrupt calls from the logical GID driver. After installation, the 
application informs the logical GID driver that it is ready to receive interrupts by calling the 
SF__EVENT__ON subfunction. After event interrupts have been enabled, the application will 


receive an interrupt every time the logical GID driver receives data from the hardware interface 
level. 
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4.2.2 Data Structures 


The application interface level uses two major data structures: the Logical Describe Record and 
the Logical ISR Event Record(s). These data structures help keep track of the numerous events 
occurring in the Input System. a 


4.2.2.1 Logical Describe Record 


The Logical Describe Record is used by the logical GID drivers to keep track of the current state 
of their respective devices. Each of the logical GID drivers has a Logical Describe Record 
associated with it, which is located directly after the driver header starting with memory address 
DS:0010H. An explanation of the Logical Describe Record fields follows, see table 4.1 for field 
types and offsets. 


Table 4.1 


Logical GID Driver Describe Record 


Type Offset Description 


Driver Header OOH Driver Header (see Section 2) 
LD__SOURCE BYTE 10H Device GID type 
LD__HPHIL_ID BYTE 11H Physical device ID 
LD__DEVICE_STATE WORD 12H Status bits for the logical device 
LD__INDEX BYTE 14H Physical device vector number 


LD__MAX__AXIS 15H Maximum number of axes reported 
LD__CLASS 16H Device class 

LD__PROMPTS 17H Number of button/prompts 

LD__ RESERVED 18H-1BH Reserved 

LD__TRANSITION 1CH Button transitions 


LD__STATE Current state of the buttons 
LD__RESOLUTION Logical device resolution 

Maximum x-axis count 

Maximum y-axis count 

X position data for absolute devices 


Y position data for absolute devices 

X delta for relative devices 

Y delta for relative devices 

X-axis scaling accumulator 
LD_ACCUM__Y Y-axis scaling accumulator 
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LD__ SOURCE This field is divided into nibbles. Bits 7-4 contain the graphics input 
device type. This field is loaded with the low order nibble of the 
appropriate logical GID data type (table 4.5). Bits 3-0 are reserved. 


LD__HPHIL__ID ID byte of the physical device which last reported data. See table 4.2 for 
a list of HP-HIL ID bytes. 
LD__DEVICE__STATE Status bits for the logical device 
Definition 
OFH-O5H_— Reserved. 
04H Event enabled when set. 
03H Tracking enabled when set. 
02H Clipping enabled when set. 
01H Button error occurred when set. 
OOH Interrupt In progress when set. 

LD__INDEX This contains the vector address divided by 6 of the last physical 
device that reported data. 

LD__MAX__AXIS Maximum number of axes supported by the device. Valid range is 
0-2. 

LD__CLASS Device class. Bits 7-4 contain the current class. Bits 3-0 contain the 
default class. See Appendix G for more information on device 
classes. 

LD__PROMPTS Number of buttons and prompts supported by the device. Bits 7-4 
contain the number of prompts. Bits 3-0 contain the number of 
buttons. 

LD__TRANSITION Transitions reported per button, |.e., a set bit indicates that the 


corresponding button was either pushed or released. Bit 7 
corresponds to button 7 etc. 


LD__STATE Current state of the buttons. 1 is down, 0 is up. Bit 7 corresponds 
to button 7 etc. If LD__STATE is XOR’ed with LD__TRANSITION the 
result is the previous button state. 


LD__RESOLUTION This is the resolution of the logical device. For logical devices this is 
typically one. 
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Table 4.2 


HP-HIL Device ID Bytes 


Device Type 


Keyboard 


Other 


Character 
Entry 


Relative 


Positioners 


ID Range 
QOH-O2H 
0 


O8H-OAH 
OBH 
OCH 
ODH 
OEH 
OFH 
10H-12H 
13H 
14H 
15H 
16H 
17H 
18H 
19H 
1AH 
1BH 
1CH 
1DH 
1EH 
1FH 


2OH-2BH 
2CH-2FH 
30H-3FH 


40H-4FH 
5OH-5BH 
5CH-SFH 


60H-67H 
68H-6BH 
6CH-6FH 
(OQH-7FH 
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Device Description 


Reserved 

Swiss-French Keyboard 
Reserved 

Canadian-English Keyboard 
Reserved 

Itallan Keyboard 

Reserved 

Dutch Keyboard 

Swedish Keyboard 

German Keyboard 
Reserved 

Spanish 

Reserved 

Belgian (Flemish) Keyboard 
Finnish Keyboard 

United Kingdom Keyboard 
French-Canadian Keyboard 
Swiss-German Keyboard 
Norwegian Keyboard 
French Keyboard 

Danish Keyboard 

Katakana Keyboard 

Latin American-Spanish Keyboard 
United States-American Keyboard 


Reserved 
Tone Generator 
Reserved 


Reserved 
Reserved 
Barcode Reader 
Reserved 
Mouse 
Trackball 
Reserved 


Device Type ID Range Device Description 


Absolute 80H-87H Reserved 

Positioners 88H-8BH Touchpad 
8CH-8FH Touch Screen 
Q9OH-97H — Graphics Tablet 


98H-9FH Reserved 


OAQH-OBFH Compressed Keyboard (91—93 keys) 
OQCOQH-ODFH Extended Keyboard (107-109 keys) 
QEOH-OFFH Standard Keyboard (85-87 keys) 


LD__SIZE__X Maximum count (in units of resolution) for the x-axis. 

LD__SIZE__Y Maximum count (in units of resolution) for the y-axis. 

LD__ABS__X X position data for devices which report absolute coordinates 
(absolute devices). 

LD__ABS__Y Y position data for devices which report absolute coordinates. 

LD__REL__X Latest change In x position for devices which return coordinates 


relative to the previous position (relative devices). 


LD__REL__Y Latest change in y position for devices which return coordinates 
relative to the previous position. 


LD_ACCUM__X Accumulator used to sum partial movements when scaling from 
the physical device space to the logical device space. The value 
stored here represents a fraction of one logical unit for the x-axis. 


LD__ACCUM__Y Accumulator used to sum partial movements when scaling from 
the physical device space to the logical device space. The value 
stored here represents a fraction of one logical unit for the y-axis. 


4.2.2.2 Logical ISR Event Records 


A Logical ISR Event Record is not a data structure in the truest sense, but is a set of register 
definitions for inter-driver communication of input events. These definitions apply not only to 
Input System drivers but to application event drivers as well. Tables 4.3 and 4.4 define the 
Logical ISR Event Records. 
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Table 4.3 
GID Button ISR Event Record 


F__ISR (OOH) 
Physical device driver's vector address / 6 
Button information. 


Bit Value Definition 
OFH-O8H Reserved 


O7H Button up 
Button down 
O6H-OOH Button number (0-7) 


Data Type 
Pointer to Physical device driver header and Physical Describe Record. 


Table 4.4 
GID Motion ISR Event Record 


AH = F__ISR (00H) 
DL = Physical device driver's vector address / 6 
BX = X axis motion in raw data form. 
CX = Y axis motion in raw data form. 
DH = Data Type 
ES:0 = Pointer to physical device driver header and Physical Describe Record. 


The button number in the Button information field (BX) denotes which button on the device is 
reporting data. Of special interest is button seven (proximity indicator) which is currently used by 
absolute devices to indicate that the device measurement field is active. For example, someone is 
touching the touch screen or the stylus is in contact with the tablet surface. 


The Data Type field (DH) contains a code representing the current type of logical GID data stored 
in the event record. For button events this value will be T_KC__ BUTTON. For logical GID motion 
events permissible types are: T__TS, T__POINTER and T__TABLET, which correspond to data 
Originating from V__LTOUCH, V__LPOINTER, and V__LTABLET respectively. For a complete list of 
logical GID event data types see table 4.5. 
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Table 4.5 


Logical GID Event Data Types 


Type Value Definition 


T_KC__BUTTON O9H Button data 


T_TS 45H Specially formed data (80 x 25—default) generated by 
V__LTOUCH 

T__TABLET 46H Specially formed data (640 x 200 range—default) 
generated by V__LTABLET 

T__POINTER 47H Specially formed data (640 x 200 range—default) 


generated by V__LPOINTER 


4.2.2.3 Application Event Drivers 


As previously mentioned, applications may install a routine to handle interrupts from the logical 
GID drivers. Three predefined vectors in the HP_VECTOR_TABLE are initialized to the null driver 
(V__PNULL). The three vectors are V__EVENT__TOUCH, V__EVENT__POINTER, and 
V__EVENT__TABLET which are called by the logical GID drivers V_LTOUCH, V__LPOINTER, and 
VV__LTABLET respectively when event interrupts are enabled by a call to SF__EVENT__ON. A call 
to SF__CREATE__EVENT sets the corresponding event vector to point to the user application 
event driver instead of the null driver. 


The application event driver is required to support only one function, F__ISR. The driver should 
return RS__UNSUPPORTED for all unimplemented functions. 


4.2.3. Logical GID Drivers 


The drivers V__LTOUCH, V__LPOINTER and V__LTABLET represent the application interface to 
the Input System. These drivers provide functions to poll for data, enable/disable application 
event interrupts, enable/disable tracking and enable/disable clipping and/or scaling. 
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4.2.3.1 V__LTOUCH Driver (BP = O0C6H) 


This section contains a detailed description of the touch screen driver. Table 4.6 contains a 
function code summary. 


Table 4.6 


Touch Screen Driver Function Code Summary 


Vector Func. Function 
Address Value Equate Definition 


OOC6H V__LTOUCH Application interface to Touch Screen 
OOC6H QO F__ISR Logical Interrupt 


02 F__SYSTEM System functions 

02/00 SF__INIT Initialize the driver data area 
OQ2/02 SF__START Start driver 

02/04 SF__REPORT__STATE Report state of device 

02/06 SF__VERSION__DESC Report driver version number 
02/08 SF__DEF__ATTR Set default logical scaling attributes 
O2/0A SF__GET__ATTR Get scaling attributes 

02/0C SF__SET__ATTR Set scaling attributes 


O04 F__IO__CONTROL I/O Control functions 

04/00 SF__LOCK Unsupported 

04/02 SF__UNLOCK Unsupported 

04/04 SF__TRACK__ON Turn cursor track on 

04/06 SF__TRACK__OFF Turn cursor track off 

04/08 SF__CREATE__EVENT Establish a new routine to be called on 
logical device events 

O4/0A SF__EVENT__ON Enable event call to parent driver 

04/0C SF__EVENT__OFF Disable event call to parent driver 

O4/0E SF__CLIPPING__ON __ Enable logical device clipping 

04/10 SF__CLIPPING__OFF __ Disable logical device clipping 


OOC6H O06 F__ SAMPLE Report absolute position of GID 
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Touch Screen Driver Functions Definitions 


F_ISR (AH = OOH) 


This function receives an ISR Event record from one of the physical GID drivers. The calling driver 
has handled the physical interrupt and updated the Physical Describe Record to reflect the event. 
This function translates the physical event into the logical coordinate system and calls its parent, 
V__EVENT__TOUCH, (if EVENT is enabled). In addition, this function passes the event to 

V__ STRACK so that the sprite can be updated (if TRACK Is enabled). This function is a response 
to a logical hardware interrupt and not user callable. 


On Entry: AH = F_ISR (OOH) 
DH = Data Type 
DL = Physical device driver's vector index. 
ES:0 = Pointer to Physical device driver header and Physical Describe Record. 
BP = V__LTOUCH (O0C6H) 


For Button Event: 
BX = Button information. 


Bit Value Definition 
OFH-08H —~ Reserved 
O7H 1 Button up 

0 Button down 


O6H-OOH Button number (0-7) 
For Motion Event: 

BX = X axis motion in raw data form. 

CX = Y axis motion in raw data form. 


On Exit: AH Return Status Code 


Registers Altered: AX, BP, DS 


Related Functions: SF__CREATE__EVENT, SF__EVENT__ON, SF__TRACK__ON 
SF_INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Section 9 for a complete discussion of 
the protocol used in data space allocation. 
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On Entry: AH = F__SYSTEM (02h) 
AL = SF__INIT (OOH) 
BX = “Last used DS” in HP Data Area 
BP = V__LTOUCH (00C6H) 
On Exit: AH = Return Status Code 
BX = New “last used DS” in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF_ START (AX = 0202H) 


This subfunction starts the logical touch screen driver. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__START (02H) 
BP = V__LTOUCH (00C6H) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_.REPORT_STATE (AX = 0204H) 


This subfunction returns the LD__DEVICE__STATE field from the Logical Describe Record. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__REPORT__STATE (04H) 
BP = V__LTOUCH (00C6H) 
On Exit! AH = Return Status Code 
DX = LD__DEVICE__STATE from Logical Describe Record 


Registers Altered: AX, DX, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 
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On Entry: AH = F__SYSTEM (02h) 


AL = SF__VERSION__DESC (06H) 
BP = V__LTOUCH (00C6h) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI_ = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


SF__DEF_ATTR (AX = 0208H) 


This subfunction sets the attributes of the logical touch screen driver to their default values. The 
default attributes for the touch screen driver are: LD__SIZE_X = 79 and LD__SIZE__Y = 24. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__DEF_ATTR (08H) 
BP = V__LTOUCH (00C6H) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_GET_ATTR (AX = 020AH) 


This subfunction returns the current scaling attributes, LD__SIZE__X and LD__SIZE__Y. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__GET__ATTR (OAh) 
BP = V__LTOUCH (00C6H) 
On Exit: AH = Return Status Code 
BX = LD__SIZE_ X (logical size along X axis) 
CX = LD_SIZE__Y (logical size along Y axis) 


Registers Altered: AX, BX, CX, BP, DS 
SF_SET_ATTR (AX = 020CH) 


This subfunction sets the scaling attributes, LD__SIZE__X and LD__SIZE__Y in the Logical 
Describe Record. 
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On Entry. AH = F_SYSTEM (02H) 
AL = SF__SET__ATTR (OCH) 
BX = LD__SIZE__X (logical size along X axis) 
CX = LD_SIZE_Y (logical size along Y axis) 
BP = V__LTOUCH (00C6H) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_TRACK__ON (AX = 0404H) 


This subfunction turns tracking on. For each movement of the logical device, V__STRACK will be 
called to update the graphics cursor (sprite) position. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__TRACK__ON (04H) 
BP = V__LTOUCH (00C6H) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_TRACK__OFF (AX = 0406H) 


This subfunction turns tracking off. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__TRACK__OFF (06H) 
BP = V__LTOUCH (00C6H) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CREATE_ EVENT (AX = 0408H) 


This subfunction establishes the routine to be called on logical device events. The IP, CS, and DS 
of the routine are passed to this subfunction. These values are exchanged with the vector entry 
of the V__EVENT__TOUCH driver in the HP_VECTOR__TABLE, V__EVENT__TOUCH being the 
parent of the logical touch screen driver. The IP, CS, and DS of the previous routine are returned 
to the caller. Note that this subfunction does not enable the event call to the parent routine; this 
must be done explicitly using SF_EVENT__ON. 
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The ISR event records passed to the V__EVENT__TOUCH driver will have one of the following 
two formats depending on the Data Type stored in DL. 


V__EVENT__TOUCH Button ISR Event Record: 


= F__ISR (OOH) 
DL = Physical device driver's vector address / 6 


BX Button information. 
Bit Value Definition 
OFH-08H — Reserved 
07H 1 Button up 
0 Button down 
O6H-O0OH — Button number (0-7) 
DH = Data Type 


ES:0 = Pointer to V_.LTOUCH device driver header and Logical Describe Record. 


V__EVENT__TOUCH Motion ISR Event Record: 


AH = F__ISR (00H) 
DL = Physical device driver's vector address / 6 
BX = Anumber between 0 and LD__SIZE__X 
CX = Anumber between 0 and LD__SIZE__Y 
DH = Data Type 
ES:0 = Pointer to V_.LTOUCH device driver header and Logical Describe Record. 
On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CREATE__EVENT (08h) 
BP = V__LTOUCH (00C6H) 
DX = DS of new V_EVENT__TOUCH routine 
S| = IP of new V_EVENT__TOUCH routine 
ES = CS of new V__EVENT__TOUCH routine 
On Exit: AH = Return Status Code 
DX = DS of previous V__EVENT__TOUCH routine 
S| = IP of previous V__EVENT__TOUCH routine 
ES = CS of previous V__EVENT__TOUCH routine 


Registers Altered: AX, DX, SI, BP, ES, DS 


Related Functions: SF__EVENT__ON 


Input System and HP-HIL 69 


This example shows how to use the SF__CREATE__EVENT function. The routine EVENT will be 
the event procedure that is called when events are enabled. 


EVENT PROC FAR 
CMP AH, F__ISR ; only support function F_JSR 
JE PROCESS__EVENT 
MOV AH, RS__UNSUPPORTED 


IRET 
PROCESS__EVENT: 
, code to process data 
; (see touch screen 
; event record) 
MOV AH, RS__SUCCESSFUL ; return successful completion 
IRET 


EVENT ENDP 


MOV AH, F_JO__CONTROL 

MOV AL, SF__CREATE__EVENT 

MOV BP, V_LTOUCH 

MOV Dx, DS , want to use the current data 
; segment for event DS 


PUSH CS 

POP ES ; current CS is also segment 
; of event routine 

LEA SI, CS:EVENT ; get the IP of the event 
; routine 

PUSH DS ; save current DS 

INT HP__ENTRY ; call extended BIOS driver 

POP DS 


SF_EVENT__ON (AX = 040AH) 


This subfunction enables the event (parent) call to the touch screen event routine 
(V__EVENT__TOUCH). The link to the touch screen event routine must have already been 
established using SF_.CREATE__EVENT. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__EVENT__ON (OAH) 
BP = V__LTOUCH (00C6H) 
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On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 


Related Functions: SF_ CREATE__EVENT, SF__EVENT__OFF 


SF_EVENT_OFF (AX = 040CH) 


This subfunction disables the call to the touch screen event routine 


On Entry: AH = F_IO__CONTROL (04h) 
AL = SF__EVENT__OFF (OCH) 
BP = V__LTOUCH (00C6h) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CLIPPING ON (AX = 040EH) 


This subfunction enables logical device clipping. Physical device motion will be scaled to logical 
space and will be clipped to avoid overflow or underflow. Clipping is activated for both absolute 
and relative motion. 


When there is a relative device mapped to this device driver, clipping works the best. It will make 
sure that the new position always falls within the logical space. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CLIPPING__ON (OEH) 
BP = V__LTOUCH (00C6H) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
SF__CLIPPING OFF (AX = 0410H) 


This subfunction disables logical device clipping. Physical device motion will be scaled to logical 
space, but overflow or underflow may occur. 
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On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CLIPPING__OFF (10H) 
BP = V__LTOUCH (O0OC6H) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F_SAMPLE (AH = 06H) 


This function allows an application to poll the touch screen device. This function reports the 
current absolute position of the logical device in a form similar to a Logical ISR Event Record. 


On Entry: AH = F__SAMPLE (06H) 
BP = V__LTOUCH (00C6H) 
On Exit! AH = Return Status Code 
BX = Current logical position along X axis 
CX = Current logical position along Y axis 
DL = LD__TRANSITION field of Logical Describe Record 
DH = LD_ STATE field of Logical Describe Record 
ES:0 = Pointer to logical device header and Describe Record 


Registers Altered: AX, BX, CX, DX, BP, DS, ES 
The following is an example of how to call the F_SAMPLE function. 


MOV AH, F_SAMPLE ; load function code 
MOV BP, V_LTOUCH ; load vector address 


PUSH DS “ save the current DS 
INT  HP__ENTRY ' + call extended BIOS driver 
POP DS ; restore DS 


4.2.3.2 V__LPOINTER Driver (BP = OOCOH) 


This section contains a detailed description of the pointer driver. Table 4.7 summarizes the 
functions supported by this driver. 
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Table 4.7 


Pointer Driver Function Code Summary 


Vector 


Func. 


Address Value 


OOCOH 
OOCOH 


OOCOH 


OOCOH 
OOCOH 
OOCOH 
OOCOH 
OOCOH 


OOCOH 
OOCOH 
OQOCOH 
OOCOH 


OOCOH 


00 


O2 

02/00 
02/02 
02/04 
02/06 
02/08 
02/0A 
02/0C 


04 

04/00 
04/02 
04/04 
04/06 
04/08 


O4/0A 
04/0C 
04/0€E 
04/10 


06 


Function 
Equate 


V__LPOINTER 
F__ISR 


F_ SYSTEM 
SF__INIT 
SF__START 
SF__REPORT__STATE 
SF__VERSION__DESC 
SF__DEF__ATTR 
SF__GET__ATTR 
SF__SET__ATTR 


F__IO__ CONTROL 
SF__LOCK 
SF__UNLOCK 
SF__TRACK__ON 
SF__TRACK__OFF 
SF__CREATE__EVENT 


SF__EVENT__ON 
SF__EVENT__OFF 
SF__CLIPPING__ON 
SF__CLIPPING__OFF 


F__ SAMPLE 


Pointer Driver Function Definitions 


Definition 


Application interface to Pointer/Mouse 
Logical Interrupt 


System functions 

Initialize the driver data area 

Start driver 

Report state of device 

Report driver version number 

Set default logical scaling attributes 
Get scaling attributes 

Set scaling attributes 


I/O Control Functions 
Unsupported 

Unsupported 

Turn cursor track on 

Turn cursor track off 

Establish a new routine to be called on 
logical device events 

Enable event call to parent driver 
Disable event call to parent driver 
Enable logical device clipping 
Disable logical device clipping 


Report absolute position of GID 


F_ISR (AH = OOH) 


This function receives an ISR Event record from one of the physical GID drivers. The calling driver 
has handled the physical interrupt and updated the Physical Describe Record to reflect the event. 
This function translates the physical event into the logical coordinate system and calls its parent, 
V__EVENT__POINTER, (if EVENT is enabled). In addition, this function passes the event to 

V__ STRACK so that the sprite can be updated (if TRACK is enabled). This function is a response 
to a logical hardware interrupt and not user callable. 
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On Entry: AH = F_ISR (OOH) 
DH = Data Type 
DL = Physical device driver's vector index. 
ES:0 = Pointer to physical device driver header and Physical Describe Record. 
BP = V__LPOINTER (OOCOH) 


For Button Event: 
BX = Button information. 


Bit Value Definition 
OFH-O08H — Reserved 
07H 1 Button up 

0 Button down 
O6H-OOH — Button number (0-7) 


For Motion Event: 
BX = X axis motion in raw data form. 
CX = Y axis motion in raw data form. 


On Exit: AH Return Status Code 


Registers Altered: AX, BP, DS 


Related Functions: SF__CREATE__EVENT, SF__EVENT__ON, SF__TRACK__ON 


SF_INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Section 9 for a complete discussion of 
the protocol used in data space allocation. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__INIT (OOH) 
BX = ‘‘Last used DS” in HP Data Area 
BP = V__LPOINTER (OOCOH) 


On Exit: AH = Return Status Code 
BX = New “‘last used DS” in HP Data Area 


Registers Altered: AX, BX, BP, DS 
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SF_ START (AX = 0202H) 
This subfunction starts the logical pointer driver. 
On Entry: AH = F__SYSTEM (02H) 


AL SF__START (02H) 
BP = V__LPOINTER (OOCOH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_REPORT_STATE (AX = 0204H) 
This subfunction returns the LD__DEVICE__STATE field from the Logical Describe Record. 
On Entry: AH = F_SYSTEM (02H) 


AL SF__REPORT__STATE (04H) 
BP = V__LPOINTER (OOCOH) 


On Exit: AH = Return Status Code 
DX = LD__DEVICE__STATE from Logical Describe Record 


Registers Altered: AX, DX, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


= F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 


BP \VV__LPOINTER (OOCOH) 
On Exit: AH Return Status Code 
BX Release date code 


CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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SF_DEF_ATTR (AX = 0208H) 


This subfunction sets the attributes of the logical pointer driver to their default values. The 
default attributes for the pointer driver are: LD__SIZE_X = 639 and LD_SIZE_Y = 199. 


On Entry: AH = F_SYSTEM (02H) 
AL SF__DEF__ATTR (08H) 
BP = V__LPOINTER (OOCOH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_GET_ATTR (AX = 020AH) 
This subfunction returns the current scaling attributes, LD__SIZE__X and LD__SIZE__Y. 
On Entry: AH = F_SYSTEM (02H) 
AL = SF__GET__ATTR (OAH) 
BP = V__LPOINTER (OOCOH) 
On Exit: AH = Return Status Code 
BX = LD__SIZE__X (logical size along X axis) 
CX = LD__SIZE__Y (logical size along Y axis) 


Registers Altered: AX, BX, CX, BP, DS 


SF_SET_ATTR (AX = 020CH) 


This subfunction sets the scaling attributes, LD__SIZE__X and LD__SIZE__Y in the Logical 
Describe Record. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__SET__ATTR (OCH) 
BX = LD__SIZE_X< (logical size along X axis) 
CX = LD__SIZE__Y (logical size along Y axis) 
BP = V__LPOINTER (OOCOH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF_TRACK_ON (AX = 0404H) 


This subfunction turns tracking on. For each movement of the logical device, V__STRACK will be 
called to update the graphics cursor (sprite) position. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__TRACK__ON (04H) 
BP = V__LPOINTER (OOCOH) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_TRACK__OFF (AX = 0406H) 


This subfunction turns tracking off. 


On Entry: AH = F_IO__CONTROL (04h) 
AL = SF__TRACK__OFF (06H) 
BP = V__LPOINTER (OOCOH) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CREATE_EVENT (AX = 0408H) 


This subfunction establishes the routine to be called on logical device events. The IP, CS, and DS 
of the routine are passed to this subfunction. These values are exchanged with the vector entry 
of the V__EVENT__POINTER driver in the HP__VECTOR__TABLE, V__EVENT__POINTER being the 
parent of the logical pointer driver. The IP, CS, and DS of the previous routine are returned to the 
caller. Note that this subfunction does not enable the event call to the parent routine; this must 
be done explicitly using SF__EVENT__ON. 


The ISR event records passed to the V__EVENT__POINTER driver will have one of the following 
two formats depending on the Data Type stored in DL. 


V__EVENT__POINTER Button ISR Event Record: 
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AH = F_ISR (OOH) 
DL = Physical device driver's vector address / 6 


BX Button information. 
Bit Value Definition 
OFH-08H — Reserved 
07H 1 Button up 
0 Button down 
O6H-00H — Button number (0-7) 


DH = Data Type 
ES:0 = Pointer to V_LPOINTER device driver header and Logical Describe Record. 


V__EVENT__POINTER Motion ISR Event Record: 


AH = F__ISR (OOH) 
DL = Physical device driver's vector address / 6 
BX = Relative movement in the X direction 
(Positive number indicates movement to the right) 
CX = Relative movement in the Y direction 
(Positive number indicates movement down) 
DH = Data Type 
ES:0 = Pointer to V__LPOINTER device driver header and Logical Describe Record. 
On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CREATE__EVENT (08H) 
BP = V__LPOINTER (OOCOH) 
DX = DS of new V__EVENT__POINTER routine 
S| = IP of new V__EVENT__POINTER routine 
ES = CS of new V__EVENT__POINTER routine 
On Exit: AH = Return Status Code 
DX = DS of previous V__EVENT__POINTER routine 
S! = IP of previous V_EVENT__POINTER routine 
ES = CS of previous V_EVENT__POINTER routine 


Registers Altered: AX, DX, SI, BP, ES, DS 
Related Functions: SF__EVENT__ON 
This example shows how to use the SF__CREATE__EVENT function. The routine EVENT will be 


the event procedure that is called when events are enabled. 
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EVENT PROC FAR 
CMP AH, F_JSR ; only support function F_JSR 
JE PROCESS__EVENT 
MOV AH, RS__UNSUPPORTED 
IRET 
™ = PROCESS__EVENT: 
| ; code to process data (see 
; pointer event record) 


MOV AH, RS__SUCCESSFUL ; return successful completion 
IRET 
EVENT ENDP 


MOV AH, F__IO_._CONTROL 

MOV AL, SF__CREATE__EVENT 

MOV BP, V_LPOINTER 

MOV Dx, DS ; want to use the current data 
; segment for event DS 


PUSH CS 
POP ES ; current CS is also segment 
; of event routine 
~~ LEA SI, CS:EVENT ; get the IP of the event 
, ; routine 
PUSH DS ; save current DS 
INT HP__ENTRY ; call extended BIOS driver 
POP DS 


SF_EVENT_ON (AX = 040AH) 
This subfunction enables the event (parent) call to the pointer event routine 
(V__EVENT__POINTER). The link to the pointer event routine must have already been established 
using SF__CREATE__EVENT. 
On Entry: AH = F_lIO__CONTROL (04H) 
AL = SF__EVENT__ON (OAH) 
BP = V__LPOINTER (OOCOH) 
On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 


Related Functions: SF__CREATE__EVENT, SF__EVENT__OFF 
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SF_EVENT__OFF (AX = 040CH) 
This subfunction disables the call to the pointer event routine. 
On Entry: AH = F_IO__CONTROL (04h) 
AL = SF__EVENT__OFF (OCH) 
BP = V__LPOINTER (OOCOH) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__CLIPPING. ON (AX = O040EH) 


This subfunction enables logical device clipping. Physical device motion will be scaled to logical 
space and will be clipped to avoid overflow or underflow. Clipping is activated for both absolute 
and relative motion. 


When there is a relative device mapped to this device driver, clipping works the best. It will make 
sure that the new position always falls within the logical space. 


On Entry: AH = F_IO__CONTROL (04H) 
AL SF__CLIPPING__ON (OEH) 
BP V__LPOINTER (OOCOH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__CLIPPING__OFF (AX = 0410H) 


This subfunction disables logical device clipping. Physical device motion will be scaled to logical 
space, but overflow or underflow may occur. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CLIPPING__OFF (10H) 
BP = V__LPOINTER (OCOH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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F_ SAMPLE (AH = 06H) 


This function allows an application to poll the pointer device. This function reports the current 
absolute position of the logical device in a form similar to a Logical ISR Event Record. 


On Entry: AH = F_SAMPLE (06H) 
BP = V__LPOINTER (OOCOH) 
On Exit! AH = Return Status Code 
BX = Current logical position along X axis 
CX = Current logical position along Y axis 
DL = LD__TRANSITION field of Logical Describe Record 
DH = LD_STATE field of Logical Describe Record 
ES:0 = Pointer to logical device header and Describe Record 


Registers Altered: AX, BX, CX, DX, BP, DS, ES 


The following is an example of how to call the F_SAMPLE function. 


MOV AH, F__SAMPLE ; load function code 
MOV BP, V_LPOINTER ; load vector address 
PUSH DS ; save the current DS 

INT HP__ENTRY ; call extended BIOS driver 
POP DS ; restore DS 


4.2.3.3 V__LTABLET Driver (BP = OOBAH) 


This section contains a detailed description of the tablet driver. See table 4.8 for a summary of 
functions supported by this driver. 
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Table 4.8 


Tablet Driver Function Code Summary 


Vector 


Func. 


Function 


Address Value Equate 


OOBAH 
OOBAH 


OOBAH 
OOBAH 
OOBAH 
OOBAH 
OOBAH 
OOBAH 
OOBAH 
OOBAH 


OOBAH 
OOBAH 
OOBAH 
OOBAH 
OOBAH 
OQOBAH 


OOBAH 
OOBAH 
OOBAH 
OOBAH 


OOBAH 


00 


02 

02/00 
02/02 
02/04 
02/06 
02/08 
02/0A 
02/0C 


04 

04/00 
04/02 
04/04 
04/06 
04/08 


O4/0A 
04/0C 
04/0E 
04/10 


06 


V__LTABLET 
F__ISR 


F__SYSTEM 
SF__INIT 
SF__START 
SF__REPORT__STATE 
SF__VERSION__DESC 
SF__DEF__ATTR 
SF__GET__ATTR 
SF__SET__ATTR 


F_ lO__ CONTROL 
SF__LOCK 
SF__UNLOCK 
SF__TRACK__ON 
SF__TRACK__OFF 
SF__CREATE__EVENT 


SF__EVENT__ON 
SF__EVENT__OFF 
SF__CLIPPING__ON 
SF__CLIPPING__OFF 


F__ SAMPLE 


Definition 


Application interface to Tablet 
Logical Interrupt 


System functions 

Initialize the driver data area 

Start driver 

Report state of device 

Report driver version number 

Set default logical scaling attributes 
Get scaling attributes 

Set scaling attributes 


/O Control Functions 
Unsupported 

Unsupported 

Turns cursor track on 

Turns cursor track off 

Establish a new routine to be called on 
logical device events 

Enable event call to parent driver 
Disable event call to parent driver 
Enable logical device clipping 
Disable logical device clipping 


Report absolute position of GID 


Tablet Driver Functions Definition 


F_ISR (AH = OOH) 

This function receives an ISR Event record from one of the physical GID drivers. The calling driver | 
has handled the physical interrupt and updated the Physical Describe Record to reflect the event. 

This function translates the physical event into the logical coordinate system and calls its parent, 
V__EVENT__TABLET, (if EVENT is enabled). In addition, this function passes the event to 

V__ STRACK so that the sprite can be updated (if TRACK is enabled). This function is a response 

to a logical hardware interrupt and not user callable. 
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On Entry: AH = F_ISR (OOH) 
DH = Data Type 
DL = Physical device driver's vector index. 


ES:0 = Pointer to physical device driver header and Physical Describe Record. 
BP = V__LTABLET (OOBAH) 


For Button Event: 
BX = Button information. 


Bit Value Definition 
OFH-08H _— Reserved 
O7H 1 Button up 

0 Button down 


O6H-OOH Button number (0-7) 


For Motion Event: 
BX = X axis motion in raw data form. 
CX = Y axis motion in raw data form. 
On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 


Related Functions: SF__CREATE__EVENT, SF__EVENT__ON, SF__TRACK__ON 


SF_INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Section 9 for a complete discussion of 
the protocol used in data space allocation. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__INIT (OOH) 
BX = “Last used DS” in HP Data Area 
BP = V__LTABLET (OOBAH) 
On Exit: AH = Return Status Code 
BX = New “‘last used DS” in HP Data Area 


Registers Altered: AX, BX, BP, DS 
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SF_START (AX = 0202H) 


This subfunction starts the logical tablet driver. 


On Entry: AH = F_SYSTEM (02h) 
AL = SF__START (02H) 
BP = V__LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_.REPORT__STATE (AX = 0204H) 


This subfunction returns the LD__DEVICE__STATE field from the Logical Describe Record. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__REPORT__STATE (04H) 
BP = V__LTABLET (OOBAH) 
On Exit: AH = Return Status Code 
DX = LD__DEVICE__STATE from Logical Describe Record 


Registers Altered: AX, DX, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = V__LTABLET (OOBAH) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, Dl, ES, BP, DS 
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SF_DEF_ATTR (AX = 0208H) 


This subfunction sets the attributes of the logical tablet driver to their default values. The default 
attributes for the tablet driver are: LD__SIZE_X = 639 and LD_SIZE_Y = 199. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__DEF__ATTR (08H) 
BP = V__LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_GET_ATTR (AX = 020AH) 


This subfunction returns the current scaling attributes, LD__SIZE__X and LD__SIZE__Y. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__GET__ATTR (OAH) 
BP = V__LTABLET (OOBAH) 
On Exit: AH = Return Status Code 
BX = LD__SIZE_X (logical size along X axis) 
CX = LD__SIZE__Y (logical size along Y axis) 


Registers Altered: AX, BX, CX, BP, DS 


SF_SET_ATTR (AX = 020CH) 


This subfunction sets the scaling attributes, LD__SIZE__X and LD__SIZE__Y in the Logical 
Describe Record. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__SET__ATTR (OCH) 
BX = LD__SIZE__X (logical size along X axis) 
CX = LD_SIZE__Y (logical size along Y axis) 
BP = V__LTABLET (OOBAH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF_TRACK_ON (AX = 0404H) 


This subfunction turns tracking on. For each movement of the logical device, V__STRACK will be 
called to update the graphics cursor (sprite) location. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__TRACK__ON (04H) 
BP = V__LTABLET (OOBAH) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_TRACK__OFF (AX = 0406H) 

This subfunction turns tracking off. 

On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__TRACK__OFF (06H) 
BP = V__LTABLET (OOBAH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CREATE_EVENT (AX = 0408H) 


This subfunction establishes the routine to be called on logical device events. The IP, CS, and DS 
of the routine are passed to this subfunction. These values are exchanged with the vector entry 
of the V_EVENT__TABLET driver in the HP_VECTOR_TABLE, V__EVENT__TABLET being the 
parent of the logical tablet driver. The IP, CS, and DS of the previous routine are returned to the 
caller. Note that this subfunction does not enable the event call to the parent routine; this must 
be done explicitly using SF__EVENT__ON. 


The ISR event records passed to the V__EVENT__TABLET driver will have one of the following 
two formats depending on the data type stored in DL. 
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V__EVENT__TABLET Button ISR Event Record: 


AH = F__ISR (OOH) 
DL = Physical device driver's vector address / 6 


BX Button information. 
Bit Value Definition 
OFH-08H ——- Reserved 
O7H 1 Button up 
0 Button down 
O6H-00OH — Button number (0-7) 


DH = Data Type 
ES:0 = Pointer to V_LTABLET device driver header and Logical Describe Record. 


V__EVENT__TABLET Motion ISR Event Record: 


AH = F__ISR (OOH) 
DL = Physical device driver's vector address / 6 
BX = Anumber between 0 and LD__SIZE__X 
CX = Anumber between 0 and LD__SIZE__Y 
DH = Data Type 
ES:0 = Pointer to V_TABLET device driver header and Logical Describe Record. 
On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CREATE__EVENT (08H) 
BP = V__LTABLET (OOBAH) 
DX = DS of new V__EVENT__TABLET routine 
S| = IP of new V__EVENT_TABLET routine 
ES = CS of new V__EVENT_TABLET routine 
On Exit! AH = Return Status Code 
DX = DS of previous V__EVENT__TABLET routine 
S| = IP of previous V_.EVENT__TABLET routine 
ES = CS of previous V__EVENT__TABLET routine 


Registers Altered: AX, DX, SI, BP, ES, DS 
Related Functions: SF__EVENT__ON 


This example shows how to use the SF__CREATE__EVENT function. The routine EVENT will be 
the event procedure that is called when events are enabled. 
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EVENT PROC FAR 


CMP AH, F__ISR ; only support function F__ISR 
JE PROCESS__EVENT 

MOV AH, RS__UNSUPPORTED 

IRET 


PROCESS__EVENT: 
; code to process data (see 
, tablet event record) 


MOV AH, RS__SUCCESSFUL ; return successful completion 
IRET 
EVENT ENDP 


MOV AH, F_JO__CONTROL 


MOV AL, SF__CREATE__EVENT 

MOV BP, V_LTABLET 

MOV DX, DS , want to use the current data 
; segment for event DS 

PUSH CS 

POP ES ; current CS is also segment 
, of event routine 

LEA SL CS:EVENT ; get the IP of the event 
, routine 

PUSH DS ; save current DS 

INT HP__ENTRY ; call extended BIOS driver 

POP DS 


SF_EVENT__ON (AX = 040AH) 


This subfunction enables the event (parent) call to the tablet event routine (V__EVENT__TABLET). 
The link to the tablet event routine must have already been established using 
SF__CREATE__EVENT. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__EVENT__ON (OAH) 
BP = V__LTABLET (OOBAH) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


Related Functions: SF __CREATE__EVENT, SF__EVENT__OFF 
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SF_EVENT__OFF (AX = 040CH) 
This subfunction disables the call to the tablet event routine. 
On Entry: AH = F_IO__CONTROL (04H) 


AL = SF__EVENT__OFF (OCH) 
BP = V__LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__CLIPPING_ON (AX = 040EH) 

This subfunction enables logical device clipping. Physical device motion will be scaled to logical 
space and will be clipped to avoid overflow or underflow. Clipping is activated for both absolute 
and relative motion. 


When there is a relative device mapped to this device driver, clipping works the best. It will make 
sure that the new position always falls within the logical space. 


On Entry: AH = F_IO__CONTROL (04h) 
AL = SF__CLIPPING__ON (OEH) 
BP = V__LTABLET (OOBAH) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__CLIPPING__OFF (AX = 0410H) 


This subfunction disables logical device clipping. Physical device motion will be scaled to logical 
space, but overflow or underflow may occur. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CLIPPING__OFF (10H) 
BP = V__LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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F_SAMPLE (AH = 06H) 


This function allows an application to poll the tablet device. This function reports the current 
absolute position of the logical device in a form similar to a Logical ISR Event Record. 


On Entry: AH = F__SAMPLE (06H) 
BP = V__LTABLET (OOBAH) 
On Exit: AH = Return Status Code 
BX = Current logical position along X axis 
CX = Current logical position along Y axis 
DL = LD__TRANSITION field of Logical Describe Record 
DH = LD_ STATE field of Logical Describe Record 


ES:0 = Pointer to logical device header and Describe Record 
Registers Altered: AX, BX, CX, DX, BP, DS, ES 
The following is an example of how to call the F_SAMPLE function. 


MOV AH, F_SAMPLE _— ; load function code 
MOV BP, V_LTABLET _ ,; load vector address 


PUSH DS ; save the current DS 
INT  HP__ENTRY , call extended BIOS driver 
POP DS , restore DS 


4.2.4 Application Event Driver Example 


The following program is an example of how to input touch screen data using application event 
interrupts. The program installs an application event driver using the SF_.CREATE__EVENT 
function and enables event interrupts using the SF__EVENT__ON function. The event handler 
supports only the F__ISR function which processes both button and motion Logical ISR Event 
Records. 
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Touch Example 


.286¢ 


Fifle 


§9,132 


TOUCH Example 


TOUCH Example 


DESCRIPTION: This program demonstrates how touch works. 
LIST OF SECTIONS: 


: ;s#eDRIVER aie iS Cee eRe revi rrrrrrirrirrrrrirrrrirtrititititt 


NAME : 


eenanpmenaun es 
oS 
Oo 
o 
oo 


page 
HP_SHEADER 
H_ATR 


9) 
DH_NAME_INDEX 
OH V_DEFAULT 


DH_MINOR 

HP SHEADER 

HP ENTRY 

SYSCALL 
iffnb 


endif 


ATR_HP 
CL_NULL 
TSR 


F 

F-I0 CONTROL 

SF CREATE EVENT 
SF_EVENT OFF 
SF_EVENT_ON 

RS_ SUCCESSFUL 
RS_UNSUPPORTED 
T KC_BUTTON 


TTS 
V-DOLITTLE 
V_LTOUCH 
V~EVENT_ TOUCH 
READ CHAR ECHO 
MAKE BREAK BIT 
TERMINATE PROC 


TS_EVENT_HEADR 
EXAM_HP_ATTR 


TLE ,V_DOLITTLE> 


TS _EVENT_HEADR ends 
DATA_SEG segment 


macro 
<vector> 
mov 


int 
endm 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 


equ 
equ 
equ 
equ 
equ 
equ 
equ 


segment 


+ he 
HP_SHEADE 


oqooooo°oc0ceo 


O6FH 
vector 


bp ,vector 
HP_ENTRY 


8000H 
0000H 
0000H 
0004H 
0008H 
000CH 
OOO0AH 
0000H 
0002H 
09H 


45H 

0006H 
0OC6H 
0060H 


01H 
100000008 
4CH 


reported By the 3 Me Ste 
PGID translates 

any other scancode out o 
Specially formed data 


driver to the logical drive 
to T_KC_ BUTTON and filters 
f the dafa stream 

( 0..80 x 0..25 range - defa 


ATR_HP 
<EXAM_HP_ATTR,V_EVENT_TOUCH/6 ,V_EVENT_ TOUCH ,CL_NULL,CL_NULL,V_I 
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277? 


Touch Example (cont.) 


SAVE_CS 
SAVE _IP 
SAVE _DS 
STACK 


STK TOP 
DATA_SEG 
CODE_SEG 


BEGIN: 


01 INPUT LOOP: 


EXIT PROG: 


TOUCH ENABLE 
le 


TOUCH_ENABLE 
TOUCH_HANDLER 


PROCESS ISR: 
FE 4§ 


FE 09 
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dw 
ends 
segment 
assume 
mov 
mov 
mov 
mov 
call 
mov 
int 
cmp 
jne 
call 
mov 
int 
proc 
mov 


mov 
mov 
mov 
lea 
mov 
syscall 


mov 
mov 
mov 
mov 
mov 
mov 
syscall 


cs:CODE SEG, ds :DATA_SEG, 
ax ,DATA_SEG 

ds ,ax 

os ax 

sp,STK TOP 

TOUCH ENABLE 

ah, READ CHAR ECHO 

21H 


al, 
INPUT LOOP 

TOUCH RESTORE 

ah TERMINATE PROC 
1H 


ah, F_I0_ CONTROL 


al ,SF_ CREATE EVENT 
bx cs 

es ,bx 

si, TOUCH HANDLER 
dx,TS EVENT _HEADR 


V_LTOUCH 

mov bo ,.V LTOUCH 
int HP_ENTRY 

ax ,es 


word ptr SAVE CS,ax 
word ptr SAVE IP,si 


word ptr SAVE DS,dx 
ah,F IO CONTROL 
al,SF E&VENT_ON 
V_LTOUCH 

mov bp ,V_ LTOUCH 
int HP ENTRY 

ah F ISR 

PROCESS ISR 


ah, RS_UNSUPPORTED 


dh,T_TS 
short POS REPORT 
dh, T_KC_BUTTON 


ss:DATA SEG 


,;Load up the ds register with the data segment 


;The stack segment is also in the code segment 


:Point to the top of the stack 
‘Read a character w/echo until “*" 


‘Is this the exit character? 


;Exit 


;Move my touch event handler into the HP vector tab 


‘Save the old event values 


;Start accepting calls 


;Logical interrupt? 
; yes, continue 
;set return code 


‘Save all the registers 


:Is this a position report or a make/break 


report 


an“ 


Touch Example (cont.) 


0059 74 OE je short BUTTON REPORT 
0OSB EB 23 jmp short EXIT _TOUCH 
005D B4 02 POS REPORT: mov ah,02H ‘Move the cursor to the recieved position 
OOSF 8A Fl mov dh,cl ;using the standard IBM BIOS int 10. 
0061 8A D3 mov dl,bl 
0063 8B7 00 mov bh,0 
0065S CD 10 int 10H 
0067 €B 17 jmp short EXIT TOUCH :That finishes that ISR. 
0069 F6 C3 80 BUTTON REPORT: est bl, MAKE BREAK BIT :See if this is a touch or a release. 
006C 74 OA jz short BUTTON PUSH 
OO6E BS OE mov ch,0O€H :On a release make the cursor back into 
0070 Bl OF mov cl ,OFH ‘@ line. 
0072 B4 01 mov ahvl 
0074 CD 10 int 10H 
0076 EB 08 jmp short EXIT TOUCH :That finishes a release ISR. 
0078 BS 00 BUTTON PUSH: mov ch,0 ‘Make the cursor into a box on touch. 
OO7A Bl OF mov cl,Ofh 
007C B4 Ol mov ah,l 
OO7E CD 10 int 10H 
0080 61 EXIT TOUCH: popa :Restore all the registers. 
0081 B84 00 mov ah,RS SUCCESSFUL ;Set the return status. 
0083 CF iret ‘Return from the ISR 
0084 TOUCH HANDLER endp 
0084 TOUCH RESTORE proc 
0084 B4 04 mov ah,F IO CONTROL ;Stop accepting calls 
0086 BO OC mov al ,SF_EVENT_OFF 
syscall V_LTOUCH 
0088 B80 00CE6 + mov bp ,V_LTOUCH 
008B CD 6F + int HP ENTRY 
008D B4 04 mov ah. F_I0 CONTROL ‘Restore the old event handler 
OO8F BO 08 mov al,SF_CREATE EVENT 
0091 88 1E 0000 R mov bx, word ptr SAVE_CS 
0095 8E C3 mov es ,bx 
0097 8D 36 0002 R lea si,word ptr SAVE IP 
009B 8B 16 0004 R mov dx,word ptr SAVE DS 
syscall V_LTOUCH 
OOSF BD 00CE6 + mov bp ,V_LTOUCH 
0OOA2 CD 6F + int HP ENTRY 
00A4 C3 ret 
00AS TOUCH RESTORE endp 
00A5 CODE_SEG ends 
end BEGIN 
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Touch Example (cont.) 


Macros: 
Name Length 
SYSCALL.« 4-4 we i De aS 0002 
Structures and records: 
Name Width @ fields 
Shift Width Mask Initial 
MP _SHEADER ........2.242. 0010 0009 
BH_ATR a ee ee ee ee ee 0000 
DHNAME INDEX. ......... 0002 
OH_V_DEFAULT BB ace eu Se Wes 0004 
OH_P_CLASS 0006 
DH_C CLASS 0008 
OH_V_PARENT 000A 
DH_V_CHIL 000C 
MAJOR... ee ae ee ee OO00E 
DH_MINOR..........404 0O00F 
Segments and Groups: 
Name Size Align Combine Class 
CODE SEG ..........2., 00A5 PARA NONE 
DATA SEG ..........42+4, 00A8 PARA NONE 
TS _EVENT_HEADR......... 0010 PARA NONE 
Symbols: 
Name Type Value Attr 
AUR HPs 4 Sedo 8 dow eS oO Number 8000 
BEGIN... . bo S5 oc UE pbb - He - Aa oe L NEAR 0000 CODE_SEG 
BUTTON PUSH. Beck. dhe Byok- we Seo. +k L NEAR 0078 CODE SEG 
BUTTONREPORT. ......: 5: L NEAR 0069 CODE SEG 
Se RAG dh, GR Number 
EXAM_HP_ATTR.........., Alias ATR_HP 
EXIT PROG. ......2..022., L NEAR 0018 CODE SEG 
EXIT TOUCH Rede poe age rend. re: 225, Lie oy L NEAR 0080 CODE SEG 
F IO gl ONTROL Ge Ry ke eee eS Number 0004 
F_ : Number 0000 
HP_ENTRY ..........22%, Number O006F 
INPUT LOOP. .........., L NEAR OOO0E CODE_SEG 
MAKE BREAK BIT .......... Number 0080 
POS REPORT L NEAR 0050 CODE SEG 
PROCESS ISR L NEAR 0050 CODE SEG 
READ CHAR ECHO Number 0001 
RS SUCCESSFUL. . Number 0000 
RS_ chee ron Tee . Number 0002 
SAVE CS. : L WORD 0000 DATA_SEG 
SAVE_DS. : : L WORD 0004 DATA_SEG 
SAVE_IP L WORD 0002 DATA_SEG 
SF _CREATE_ “EVENT. Number 0008 
SF_ EVENT OFF Number 000C 
SF_EVENT_ON. Number 000A 
STACK. .. L WORD 0006 DATA_SEG #0050 
STK_TOP. L WORD OOAE6 DATA_SEG 
TERMINATE PROC Number 004C 
TOUCH ENABLE . N PROC 0010 CODE SEG ®002B 
TOUCH _HANOLER. N PROC 0048 CODE SEG #003C 
TOUCH RESTORE N PROC 0084 CODE SEG #0021 
T_KC_BUTTON. Number 0009 
TTS” ‘ Number 0045 
V_DOLITTLE : Number 0006 
V_EVENT TOUCH. Number 0060 
V_-LTOUCH . Number 00C6 


48576 Bytes free 


Warning Severe 
Sonor eid: 
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4.3 Hardware Interface Level 


The hardware interface of the Input System is composed of a set of drivers to respond to 
hardware interrupts and process physical data from the input devices into a form usable by 
the application interface drivers. These drivers are shown in Figure 4.2. 


4.3.1 Overview 


This section describes the drivers, data structures, and interrupt service routine (ISR) event 
processing that takes place below the application interface level. The following data flow 
expands on step 2 of the data flow presented in Section 4.2.1. A detailed explanation of each 
step is presented after the data flow. 


1. The user touches the screen. This causes a hardware interrupt which is managed by the 
8259A interrupt controller service (V__S8259). V__S8259 responds to the interrupt 
controller chip and transfers control to the HP-HIL driver. 


2. The HP-HIL driver (V__HPHIL) services the HP-HIL controller chip, retrieving the input device 
data. V__HPHIL processes the input data and transfers control to the Input System dispatch 
service. 


3. The dispatch service (V__SINPUT) transfers control to the appropriate physical device driver 
based on the source of the input data (in this case the physical touch screen driver). 


4. The physical touch screen driver builds the Physical Describe Record and transfers control to 
the application interface driver V__LTOUCH. 


V__$8259 provides a funnel point for managing HP specific hardware. The Input System 
hardware communicates with the hardware interface drivers via three interrupts: the 8041 
service request (SVC), the 8041 Output Buffer Full (OBF), and the HP-HIL controller interrupt. The 
8041 SVC and OBF interrupts are discussed in the keyboard section (Section 5). The HP-HIL 
controller interrupt is chained to the HP-HIL driver (V__HPHIL), i.e., when V__S8259 receives an 
HP-HIL controller interrupt it generates an HP__ENTRY software interrupt to transfer control to 
V__HPHIL. 


The HP-HIL driver services the HP-HIL controller and generates the appropriate Physical ISR Event 
Record(s). After processing the input data V__HPHIL chains to V__SINPUT. 
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Hardware Interface Level Drivers 


Application 


Application 
Interface 
Drivers 


Application Interface Level 


Touch Screen 
Physical GID 
Driver 


Tablet 
Physical GID 
Driver 


Pointer 
Physical GID 
Driver 


Input Dispatch 
Service 
(V__SINPUT) 


HP-HIL Controller 
Driver 
(V__HPHIL) 


8259A Interrupt 
Controller Driver 
(V__S8259) 


Hardware Interface Level 


Physical Input Devices 


Figure 4.2 
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V__SINPUT chains to the appropriate physical device driver based on the vector index (vector 
address divided by six) stored in the Physical ISR Event Record (DL register). It provides an entry 
point into the Input System for non-HP-HIL devices. V__SINPUT also provides driver mapping 
functions that will be discussed later in this section. 


Two physical drivers will be discussed later in this section. The first is the physical GID driver 
(PGID) which handles both absolute and relative data. Because PGID can handle both types of 
GID data, it can chain to any logical GID driver; this forms the basis for Input System device driver 
mapping. The second physical driver is the null device driver (V__PNULL), which serves as a 
handler for unsupported devices. The keyboard driver is discussed in Section 5. 


4.3.1.1 Device Driver Mapping 


Each driver in the Input System has a vector in the HP_.VECTOR__TABLE, and a driver header. 
Each driver header has two fields which determine the mapping of the driver. One field contains 
the vector of the driver's parent driver and the other contains the vector of the driver's child 
driver. Refer to Section 2 and Appendix G for a detailed description of driver headers. 


Calls are made to the vector address contained in the parent field to pass the interrupt on to the 
next driver in the device driver chain, moving the data from the hardware toward the application 
via the desired logical GID driver. Hardware commands from the application are passed down 
the device driver chain to the device via the vector address contained in the child vector field. By 
changing the value of the parent or child vector field, the sequence of drivers called to handle an 
interrupt or function request is changed. In general an application may re-map a driver by 
changing the driver header directly. Functions are provided by the V__SINPUT service to map the 
physical GID drivers to the logical GID drivers. 


4.3.1.2 Device Emulation 


Device emulation occurs when one or more physical devices are mapped to a logical device that 
does not represent the original source of the data. For example, mapping a physical mouse driver 
to a logical touch screen driver allows the mouse to look like a touch screen to the application. 
The key requirement for a logical device driver to emulate other devices is that it accept both 
absolute and relative data. Referencing the above example, the logical touch screen driver which 
reports absolute data must accept both absolute (touch) data and relative (mouse) data. 
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An example of device mapping and emulation occurring in the system is the translation of mouse 
input to Cursor Control Pad (CCP) input. Since standard DOS processes keyboard input only, (not 
mouse input), the physical GID driver which processes mouse input is mapped, in its default 
state, to a driver called V__PGID__CCP. This driver causes mouse input to emulate input from the 
CCP. For an application which processes industry standard mouse input (INT 33H) to use the HP 
Mouse, the mouse physical GID driver should be mapped to the V__LHPMOUSE driver using the 
F33__ INSTALL function (see Section 6 for more details). 


4.3.2 Data Structures 


The hardware interface level uses two major data structures: the Physical Describe Record and 
the Physical ISR Event Record(s). These data structures help keep track of the numerous events 
occurring in the Input System. 


4.3.2.1 Physical Describe Record 


The Physical Describe Record is used by the physical GID drivers to keep track of the current state 
of their respective devices. Each of the physical GID drivers has a Physical Describe Record 
associated with it, which is located directly after the driver header starting with memory address 
DS:0010H. An explanation of the Physical Describe Record fields follows, table 4.9 contains the 
field types and offsets. 
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Table 4.9 


Physical GID Device Describe Record 


Driver Header 
D__ SOURCE 
D__ HPHIL__ID 


D__DESC__ MASK 


D__IO__MASK 


D__XDESC__MASK 


D__.MAX__AXIS 
D__CLASS 

D__ PROMPTS 
D__RESERVED 


D__BURST__LEN 
D__WR__REG 
D__RD__REG 
D__TRANSITION 
D__STATE 


Type Offset 


Description 


Driver header (see Section 2) 
Input type and device address 
Device ID 

Describe header byte 

Device I/O descriptor byte 


Extended describe header byte 
Maximum number of axes 
Device class 

Number of button/prompts 
Reserved 


Maximum output burst length 
Number of write registers 
Number of read registers 
Button transitions 

Current state of the buttons 


D__ RESOLUTION 
D__SIZE__X 
D__SIZE__Y 
D__ABS__X 
D__ABS__Y 


D__REL__X 
D__REL__Y 
D_ACCUM__X 
D_ACCUM__Y 


WORD 
WORD 
WORD 
WORD 
WORD 


Physical device resolution 

Maximum x-axis count 

Maximum y-axis count 

X position data for absolute devices 
Y position data for absolute devices 


X delta for relative devices 
Y delta for relative devices 
Reserved 
Reserved 


D__ SOURCE This field is divided into nibbles. Bits 7-4 contain the graphics input 
device type. This field is loaded with the low order nibble of the 
appropriate physical GID data type. See table 4.12. Bits 3-0 are the link 
address of the physical device. 

a D__HPHIL__ID ID byte of the physical device which last reported data. See table 4.2 for 


a list of HP-HIL ID bytes. 


D__DESC__MASK Physical device describe byte. This byte contains information about the 
physical device characteristics, see HP-HIL Technical Reference Manual 


for more information. 
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D__IO__MASK 


D__XDESC__MASK 


D__MAX__AXIS 
D__CLASS 

D__ PROMPTS 
D__BURST__LEN 
D__WR__REG 
D__RD__REG 
D__TRANSITION 
D__STATE 


D__ RESOLUTION 


D__SIZE__X 
D__SIZE__Y 


D__ABS__X 


D__ABS__Y 
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Physical device I/O descriptor byte. This byte contains information on the 
number of prompts and acknowledges the device supports. See HP-HIL 
Technical Reference Manual for more information. 

Physical device extended describe byte. This byte contains additional 
device characteristics. See HP-H/L Technical Reference Manual for more 
information. 

Maximum number of axes supported by the device. Valid range is 0-2. 


Device class. Bits 7-4 contain the current class. Bits 3-0 contain the 
default class. See Appendix G for more information on device classes. 


Number of buttons and prompts supported by the device. Bits 7-4 is the 
number of prompts. Bits 3-0 is the number of buttons. 


Maximum number of bytes that can be output to the device using a 
single write command. 


Number of write registers supported by the device. 

Number of read registers supported by the device. 

Transitions reported per button, i.e. a set bit indicates that the 
corresponding button was either pushed or released. Bit 7 corresponds 
to button 7 etc. 

Current state of the buttons. 1 is down, 0 is up. Bit 7 corresponds to 
button 7 etc. If D__STATE is XOR’ed with D__TRANSITION the result is 
the previous button state. 

This is the resolution of the physical device. The resolution is in counts 
per meter for devices that report 8 bits of data. For devices that report 
16 bits of data the resolution is in counts per centimeter. 

Maximum count (in units of resolution) for the x-axis. 


Maximum count (in units of resolution) for the y-axis. 


X position data for devices which report absolute coordinates (absolute 
devices). 


Y position data for devices which report absolute coordinates. 


D__REL_x Latest change in x position for devices which return coordinates relative 
to the previous position (relative devices). 


D__REL__Y Latest change in y position for devices which return coordinates relative 
to the previous position. 


4.3.2.2 Physical ISR Event Records 


A Physical ISR Event Record is not a data structure in the truest sense, but is a set of register 
definitions for inter-driver communication of input events. Tables 4.10 and 4.11 define the 
Physical ISR Event Records. 


Table 4.10 
GID Button ISR Event Record 


F__ ISR (OOH) 
Physical device driver's vector address / 6 
Button information. 


Bit Value _— Definition 
OFH-O8H Reserved 
O7H Button up 

Button down 
Q6H-OOH Button number (0-7) 


Data Type 


Pointer to physical device driver header and Physical Describe Record. 
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Table 4.11 
GID Motion ISR Event Record 


F__ISR (OOH) 

Physical device driver's vector address / 6 

X axis motion in raw data form. 

Y axis motion in raw data form. 

Data Type 

Pointer to physical device driver header and Physical Describe Record. 


'@) 
me ke, PS 
ee ee 


The button number in the Button Transition Information field (BX) denotes which button on the 
device is reporting data. Of special interest is button seven (proximity indicator) which is currently 
used by absolute devices to indicate that the device measurement field is active, ie. someone is 
touching the touch screen or the stylus is in contact with the tablet surface. 


The Data Type field (DH) contains a code representing the current type of physical GID data 
stored in the event record. For button events this value will be T_KC__BUTTON. For a complete 
list of physical GID event data types see table 4.12. 

Table 4.12 


Physical GID Event Data Types 


Type Value Definition 


T_KC_ BUTTON O9H _ Button data. 
T__RELO8 40H Signed 8 bit relative data 


T__REL16 41H Signed 16 bit relative data 
T_ABS08 42H Unsigned 8 bit absolute data 
T_ABS16 43H Unsigned 16 bit absolute data 


4.3.3 Hardware Interface Level Drivers 


This section describes the hardware interface level drivers in detail. 
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4.3.3.1 V__S8259 Driver (BP = 001EH) 


The V__S8259 driver services the HP 8259A slave interrupt controller. Three interrupt request 
lines are connected to this controller; the 8041 SVC (Service port) service request, the HP-HIL 
controller, and the 8041 OBF (Output Buffer Full) service request. 


When this driver is initialized, the interrupt vectors for the three interrupts listed above are set for 
their respective entry points into the V__S8259 driver. When an interrupt occurs, control is 
transferred to one of the three entry points. The V__S8259 driver will perform an F__ISR call to 
one of three drivers; the V__8041 driver for the 8041 SVC interrupt, the V__HPHIL driver for the 
HP-HIL controller interrupt, and the INT O9H driver for the 8041 OBF interrupt. 


In the case of the 8041 SVC interrupt and the HP-HIL controller interrupt the corresponding 
interrupt is masked off on the HP slave controller and an End-of-Interrupt command is sent to the 
master interrupt controller before passing the interrupt on (via F__ISR). This allows other 
interrupts even of lower priority to be serviced on the HP slave 8259A but does not require 
interrupt handlers to be interrupt reentrant since the same interrupt is not allowed to fire until 
the entire driver chain has completed processing. When these two driver chains finish processing 
the V__S8259 issues a specific End-of-Interrupt command to the HP 8259A slave controller and 
then unmasks the corresponding interrupt so it can fire again. 


In the case of the 8041 OBF interrupt a specific End-of-Interrupt is sent to the HP slave controller 
before passing on the interrupt, allowing the industry standard INT O9H driver to manage the 
master 8259A controller as if the HP slave controller were not present. 


In addition to initiating response to the hardware interrupts, the 8259A driver contains other 
functions which initialize the interrupt vectors, and program the proper parameters into the HP 
8259A slave interrupt controller. 


V__$8259 Driver Function Definitions 


A summary of the V__S8259 function codes is provided in table 4.13. 
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Table 4.13 


V__S$8259 Function Code Summary 


Vector Func. 
Address Value 


001EH 
001EH 
OO1EH 
O01EH 
001EH 


OO1EH 
OO1EH 
OO1EH 
O01EH 
O01EH 
O01EH 
O01EH 


F_ISR (AH = OOH) 


Function 
Equate 


V__ $8259 

F__ SYSTEM 
SF__INIT 
SF__START 
SF__VERSION__DESC 

F__IO__ CONTROL 
SF__ENABLE__SVC 
SF-DISABLE__SVC 
SF__ENABLE__KBD 
SF__DISABLE__ KBD 
SF__ENABLE__HPHIL 
SF__DISABLE__HPHIL 


Definition 


8259 interrupt controller support 
System functions 

Initialize HP slave 8259A 

Enable HP slave 8259A interrupts 
Report HP version number 

Entry point to I/O control functions 
Unmask svc/8041 interrupt 

Mask svc/8041 interrupt 

Unmask keyboard INT 9 interrupt 
Mask keyboard INT 9 interrupt 
Unmask HP-HIL interrupt 

Mask HP-HIL interrupt 


Because this driver directly services hardware interrupts from an 8259A interrupt controller, this 
function is not applicable. If called, this function will return a Return Status Code of 


RS__UNSUPPORTED. 


SF_INIT (AX = 0200H) 


This subfunction sets the interrupt vectors for the three HP 8259A slave interrupt sources to the 
appropriate entry points in the driver. In addition, the necessary 8259A parameters are 
programmed into the HP 8259A slave interrupt controller. This subfunction leaves interrupts 
disabled. They must be enabled with the SF__START subfunction. 


On Entry: AH = 
AL = 
BP = 
On Exit: AH = 


F__SYSTEM (02H) 
SF__INIT (OOH) 
V__S8259 (001EH) 


Return Status Code 


Registers Altered: AX, BP, DS 
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SF_START (AX = 0202H) 


This subfunction enables the interrupts on the HP 8259A slave interrupt controller. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__START (02H) 
BP = V__S8259 (001EH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = V__S8259 (001EH) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


SF_ENABLE_SVC (AX = 00400H) 


This function unmasks (enables) the 8041 SVC interrupt on the HP 8259A slave controller. 


On Entry: AH = F_IO__CONTROL (044) 
AL = SF__ENABLE__SVC (00H) 
BP = V__S8259 (001EH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF__ DISABLE_ SVC (AX = 0402H) 
This function masks off (disables) the 8041 SVC interrupt on the HP 8259A slave controller. 
On Entry: AH = F_IO__CONTROL (04H) 


AL = SF__DISABLE__SVC (02H) 
V__ $8259 (001EH) 


oo 
me) 
I 


On Exit: AH Return Status Code 


Registers Altered: AX, BP, DS 


SF_ENABLE_KBD (AX = 0404H) 


This function unmasks (enables) the 8041 OBF interrupt on the HP 8259A slave controller. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__ENABLE__KBD (04H) 
BP = V__S8259 (001EH) 

On Exit, AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_DISABLE_KBD (AX = 0406H) 
This routine masks off (disables) the 8041 OBF interrupt on the HP 8259A slave controller. 
On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__DISABLE__KBD (06H) 
BP = V__$8259 (001EH) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF_ENABLE__HPHIL (AX = 0408H) 


This routine unmasks (enables) the HP-HIL controller interrupt on the HP 8259A slave controller. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__ENABLE__HPHIL (08H) 
BP = V__S8259 (001EH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__DISABLE__HPHIL (AX = 040Ah) 


This routine masks off (disables) the HP-HIL controller interrupt on the HP 8259A slave controller. 


On Entry: AH = F_IO__CONTROL (04h) 
AL = SF__DISABLE__HPHIL (OAH) 
BP = V__S8259 (001EH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


4.3.3.2 V__HPHIL Driver (BP = 0114H) 


The HP-HIL driver retrieves input data from the HP-HIL controller and builds an ISR Event Record 
to pass to V__SINPUT. 


A summary of the V__HPHIL function codes is provided in table 4.14. 
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Table 4.14 


V__HPHIL Driver Function Code Summary 


Vector 


0114H 


0114H 


0114H 
0114H 
0114H 
0114H 


0114H 
0114H 


0114H 
0114H 
0114H 


0114H 
0114H 


0114H 


0114H 
0114H 


01174H 
0114H 


0114H 
0114H 
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Func. 


00 


O2 

02/00 
02/04 
02/06 


02/0E 
02/10 


04 
04/04 
04/06 


04/08 
O04/0A 


04/0C 


04/0E 
04/10 


04/12 
04/14 


04/16 
04/18 


06 
08 
OA 


Function 
Address Value Equate 


V__HPHIL 


F_ 
F__ 


= 


=_ 
F_ 
F__ 


ISR 


SYSTEM 
SF__INIT 
SF__REPORT__STATE 
SF__VERSION__DESC 


SF__OPEN 
SF__CLOSE 


lO__CONTROL 
SF__CRV__CRV__MAJ__MIN 
SF__CRV__RECONFIGURE 


SF__CRV__WR__PROMPTS 
SF__CRV__WR__ACK 


SF__CRV__REPEAT 


SF__CRV__DISABLE__ REPEAT 
SF__CRV__SELF__TEST 


SF__CRV__REPORT__STATUS 
SF__CRV__REPORT__NAME 


SF__KEYBOARD__REPEAT 
SF__KEYBOARD__LED 


PUT__BYTE 
GET__BYTE 
PUT__BUFFER 


Definition 


Setup HP-HIL to INPUT driver 
linkage 

Logical Interrupt 

System Functions 

Initializes the driver data area. 
Reports state of device 
Reports driver version 
number. 

Put driver in open state. 

Put driver in open state. 


I/O control to driver 
Reserved 

Forces HP-HIL to reconfigure 
all devices. 

Write a prompt to a device 
Write an acknowledge to a 
device 

Sets either 30Hz or 60Hz 
repeat rate 

Cancels keyboard repeat rate 
Issue self-test Command to 
physical device. 

Get status from any HP-HIL 
device that needs to report 
Returns the ASCII name for a 
device 

Set typematic values 

Sets keyboard LED states 


Write one byte to specified 
HP-HIL device. 

Read one byte from specified 
HP-HIL device. 

Write a string of bytes to HP- 
HIL device. 


V__HPHIL Driver Function Definitions 


F_ISR (AH = OOH) 


This function is called by the V__S8259 driver to initiate processing of an interrupt from the HP- 
HIL controller. This function reads input device data from the HP-HIL controller, generates one or 
more ISR Event Records, and chains to V__SINPUT. THIS FUNCTION SHOULD ONLY BE CALLED 
BY THE V__S8259 DRIVER. 


On Entry: AH 
BP 


F__ISR (OOH) 
V__HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_INIT (AX = 0200H) 


This subfunction initializes the driver and HP-HIL controller. Refer to Section 9 for a complete 
discussion of the protocol utilized in data space allocation (‘last used DS” passed in register BX). 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__INIT (OOH) 
BX = “Last used DS” in HP Data Area 
BP = V__HPHIL (0114H) 
On Exit: | AH = Return Status Code 
BX = New ‘last used DS” in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF_.REPORT__STATE (AX = 0204H) 


This subfunction returns the current status of V__HPHIL. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__REPORT__STATE (04H) 
BP = V__HPHIL (0114H) 
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On Exit: AH = Return Status Code 


BX = Status word 


Bit Value 


OFH-ODH 
OCH 


O5H-04H 
O3H 
02H 
O1H 
OOH 


@) 
O) 
ke 


Registers Altered: AX, BX, BP, DS 


Definition 

Reserved 

Timeout has occurred 

Output request has completed 
Reserved 

Error during output request 
HP-HIL link has been reconfigured 
Reserved 

HP-HIL driver is open 

HP-HIL driver is closed 
Reserved 

General failure 

No devices attached. 

Reserved 

Link configuration in progress 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 


week of the year. 


Number of bytes in current version number 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = V__HPHIL (0114H) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = 
ES:DI = 


Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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SF_OPEN (AX = 020EH) 


This subfunction puts the HP-HIL driver in the open state. When the driver has been placed in the 
open state, output to the HP-HIL devices is allowed. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__OPEN (OEH) 
BP = V__HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CLOSE (AX = 0210H) 


This subfunction puts the HP-HIL driver in the closed state. When the driver has been placed in 
the closed state, output to the HP-HIL devices is not allowed. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__CLOSE (10H) 
BP = V__HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CRV__RECONFIGURE (AX = 0406H) 
This subfunction instructs the HP-HIL controller to reconfigure the link. 
On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CRV__RECONFIGURE (06h) 
BP = V__HPHIL (0114H) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF_CRV_WR_PROMPTS (AX = 0408H) 


This subfunction issues a prompt command to a device on the HP-HIL link. The prompt command 
is either specific (prompt number 1 - 7) or generic (a prompt number other than 1 - 7). 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF_.CRV__WR__PROMPTS (08H) 


BX = Device address indicator 
Bit Value Definition 
OFH-OEH — Reserved 
ODH 1 Valid address is present in DH 
0 Reserved for future enhancement, currently returns 
RS__FAIL 
OCH 1 Valid register is present in DL 
OBH-OOH — Reserved 
DH = HP-HIL device address 


DL = Prompt number 
= V__HPHIL (0114H) 


On Exit: AH Return Status Code 


Registers Altered: AX, BP, DS 


SF_CRV_WR_ACK (AX = 040AH) 


This subfunction issues an acknowledge command to a device on the HP-HIL link. The 
acknowledge command is either specific (acknowledge number 1 - 7) or generic (an 
acknowledge number other than 1 - 7). 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CRV__WR__ACK (OAH) 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH — Reserved 
ODH 1 Valid address is present in DH 
0 Reserved for future enhancement, currently returns 
RS__FAIL 
OCH 1 Valid register is present in DL 
OBH-OOH — Reserved 
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J 


DH = HP-HIL device address (major address) 
DL = Acknowledge number 
BP = V__HPHIL (0114H) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CRV__REPEAT (AX = 040CH) 


This subfunction sets the key repeat rate of a specific HP-HIL device. A repeat rate of 30 or 60 
times a second may be specified. This subfunction will only operate if the HP-HIL driver is in the 
open state. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CRV__REPEAT (OCH) 


BX = Device address indicator 
Bit Value Definition 
OFH-OEH — Reserved. 
ODH 1 Valid address is present in DH. 
0 Reserved for future enhancement, currently returns 
RS__FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH — Reserved. 
CL O for a repeat rate of 30 Hz, 1 for 60 Hz 


DH = HP-HIL device address (major address) 
= V__HPHIL (0114H) 


On Exit: AH 


Return Status Code 


Registers Altered: AX, BP, DS 
SF_CRV__DISABLE_ REPEAT (AX = 040EH) 


This subfunction disables the key repeat of a specified HP-HIL device. This subfunction will only 
operate if the HP-HIL driver is in the open state. 
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On Entry: AH = F_IO__CONTROL (04H) 


AL = SF__CRV__DISABLE__REPEAT (OEH) 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH — Reserved 
ODH 1 Valid address is present in DH. 
0 Reserved for future enhancement, currently returns 
RS__ FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH —— Reserved 


DH = HP-HIL device address (major address) 
BP = V__HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CRV__SELF_TEST (AX = 0410H) 


This subfunction initiates device self-test on the specified HP-HIL device. The HP-HIL device will 
respond with a one byte status code indicating the result of the test. This subfunction should not 
be called with an HP-HIL device address of zero (all devices), as the test could then take up to 1.5 
seconds to execute. Also, if one of the devices fails, there would be no way to determine which 
device reported a failure. 


On exit the buffer has the return status of the self-test done on the physical device. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CRV__SELF__TEST (10H) 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH — Reserved 
ODH 1 Valid address is present in DH 
0 Reserved for future enhancement, currently returns 
RS__ FAIL 
OCH 1 Valid register is present in DL 
OBH-O0OH — Reserved 


DH = HP-HIL device address (major address) 
BP = V__HPHIL (0114H) 
ES:S| = Pointer to a buffer area 
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-_ 


On Exit: AH 
ES:SI 
CX 


Return Status Code 
Pointer to buffer area 
Number of bytes in buffer 


Registers Altered: AX, CX, BP, DS 


SF__CRV__REPORT_STATUS (AX = 0412H) 


This subfunction issues a send status command to a specified HP-HIL device. The returned status 
information ranges from 1 to 15 bytes in length. A pointer to a 15 byte buffer must be passed to 
the subfunction. This subfunction will only operate if the HP-HIL driver is in the open state. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CRV__REPORT__STATUS (12H) 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH — Reserved 
ODH 1 Valid address Is present in DH. 
@) Reserved for future enhancement, currently returns 
RS___FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH — Reserved 
DH HP-HIL device address (major address) 


BP = V__HPHIL (0114H) 
= Pointer to a buffer area 


On Exit: AH = Return Status Code 
ES:S| = Pointer to buffer area 
CX = Number of bytes in buffer 


Registers Altered: AX, CX, BP, DS 


SF_CRV__REPORT_NAME (AX = 0414H) 
This subfunction issues a report name command to a specified HP-HIL device. The returned name 


information ranges from 1 to 15 bytes in length. A pointer to a 15 byte buffer must be passed to 
the subfunction. This subfunction will only operate if the HP-HIL driver is in the open state. 
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On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CRV__REPORT__NAME (14H) 


BX = Device address indicator 
Bit Value Definition 
OFH-OEH — Reserved 
ODH 1 Valid address is present in DH. 
0 Reserved for future enhancement, currently returns 
RS__FAIL. 
OCH 1 Valid register is present in DL. 
OBH-O0OH — Reserved 
DH = HP-HIL device address (major address) 


BP = V__HPHIL (0114H) 
= Pointer to a buffer area 


On Exit: AH = Return Status Code 
ES:S| = Pointer to buffer area 
CX = Number of bytes in buffer 


Registers Altered: AX, CX, BP, DS 


SF__.KEYBOARD__REPEAT (AX = 0416H) 


This subfunction sets the typematic rate and delay values for the keyboard. The Cursor Control 
keypad (CCP) may be set independent of the rest of the keyboard, i.e. the CCP may start 
repeating and repeat at different rates from the rest of the keyboard. See Section 5 for more 
information. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__KEYBOARD__REPEAT (16H) 


BH If BH = O set the typematic rate only, if BH = 1 set the delay only, if BH = 2 
set both values. 
BL = If BL = O the typematic rate and delay values are for the non-CCP keypads, If 


BL = 1 the values are for the Cursor Control keypad only. 
DL = Bits 0-3 contain the typematic rate, Bits 4-7 contain the delay value. See 
Section 5, function F16__DEF__ATTR for permissable values. 
BP = V__HPHIL (0114H) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF_KEYBOARD__LED (AX = 0418H) 


This subfunction controls the state of three keyboard LED indicators. See Section 5 for more 
information. 


If back to back calls to this function are made, only the most current value will be written to the 
keyboard device. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF_KEYBOARD__LED (18H) 
BL = Bit mask 
Bit Value Definition 
07H-03H — Reserved 
O2H 1 Turn on Caps lock LED 
0 Turn off Caps lock LED 
O1H 1 Turn on Num lock LED 
0 Turn off Num lock LED 
OOH 1 Turn on Scroll lock LED 
0 Turn off Scroll lock LED 
BP = V__HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
F_PUT__BYTE (AH = 06H) 


This function outputs a byte of data to a specific HP-HIL device register. This function will only 
operate if the HP-HIL driver is in the open state. 
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On Entry: AH = 
AL = Byte to output 


F__PUT__BYTE (06H) 


BX = Device address indicator 
Bit Value Definition 
OFH-OEH — Reserved 
ODH 1 Valid address is present in DH 
0 Reserved for future enhancement, currently returns 
RS__FAIL 
OCH 1 Valid register is present in DL 
OBH-00H — Reserved 
DH = HP-HIL device address 


On Exit: AH 


Registers Altered: AX, BP, DS | 


F_GET_BYTE (AH = 08H) 


Return Status Code 


DL = HP-HIL device register (0-127) 
= V__HPHIL (0114H) 


This function returns the contents of a specific HP-HIL device register. This function will only 
operate if the HP-HIL driver Is in the open state. 


On Entry: AH = F__GET__BYTE (08H) 
BX = Device address indicator 


Definition 


- Reserve Value Definition 


Reserved 

Valid address is present in DH 

Reserved for future enhancement, currently returns 
RS__ FAIL 

Valid register is present in DL 

Reserved 


Bit Value 
OFH-OEH — 
OFH-OEH — 
ODH 1 
0 
OCH 1 
OBH-O0H — 
DH HP-HIL device address 


V__HPHIL (0114H) 
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DL = HP-HIL device register (0-127) 


On Exit: AH 
AL 


Return Status Code 
Contents of specified register 


Registers Altered: AX, BP, DS 


F_PUT__BUFFER (AH = OAH) 


This function outputs a buffer to a specific HP-HIL device register. The HP-HIL controller and 
devices are capable of data transfer at rates up to 6500 bytes per second. If the number of bytes 
in the buffer is greater than the number the HP-HIL device can handle, this function will transfer 
as many bytes as possible to the device, and adjust the value in CX to reflect the number of bytes 
left in the buffer (not sent to the device). 


On Entry: AH = F__PUT__BUFFER (OAH) 
BX = Device address indicator 


Bit Value Definition 
OFH-OEH — Reserved 
ODH 1 Valid address is present in DH 
0 Reserved for future enhancement, currently returns 
RS__FAIL 
OCH 1 Valid register is present in DL 
OBH-OOH — Reserved 
CX = Number of bytes in buffer 
DH = HP-HIL device address 
DL = HP-HIL device register (0-127) 
BP = V__HPHIL (0114H) 
ES:S|_ = Pointer to buffer containing data to output 
On Exit: AH = Return Status Code 
CX = 0 means all the data in buffer is transferred, otherwise the number of bytes 


left in buffer. 


Registers Altered: AX, CX, BP, DS 


4.3.3.3 V__SINPUT (BP = 002AH) 


The V__SINPUT driver dispatches ISR events generated by the HP-HIL controller to the appropriate 
physical driver, thus providing an entry point into the Input System for non-HP-HIL devices (i.e., 
RS-232 mice, tablets, etc.). It also provides a number of functions which support device mapping. 
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A summary of the V__SINPUT function codes Is provided in table 4.15. 


Table 4.15 
V__SINPUT Driver Function Code Summary 


Function 
Equate 


Vector Func. 


Address Value Definition 


OO2AH 
OO2AH 


OO2AH 
OO2AH 
OO2AH 
OO2AH 
OO2AH 
OO2AH 


00 


O2/ 
02/00 
04 
04/00 
04/02 
04/04 


V__SINPUT 
F__ISR 


F__SYSTEM 
SF__INIT 

F__ IO__ CONTROL 
SF__DEF__LINKS 
SF__GET__LINKS 
SF__SET__LINKS 


Inquire Commands 
Pass ISR event record to physical driver 


System Functions 

Initialize driver 

Entry point to IO control functions 

Set header link fields to system defaults 
Return device header link field entries 
Set device header link field entries 


F__ INQUIRE Return describe record for an HP-HIL 
device. 

Return device IDs for all HP-HIL devices 
present 

Return vector address of first HP-HIL device 
driver. 


Report entry point of PGID 


F__INQUIRE__ALL 


F__INQUIRE__FIRST 


F__ REPORT__ENTRY 


V__SINPUT Driver Function Definitions 


F_ISR (AH = OOH) 


This function passes an ISR Event Record to the appropriate physical device driver based on the 
value in DL. Non-HP-HIL devices which call V__SINPUT must provide the physical device driver 
that will handle the ISR event record, and must place its vector index (vector address divided by 
six) in DL. (See Section 9, V__SYSTEM functions, to obtain a valid vector address). 


On Entry: AH = F_ISR (OOH) 
BP = V__SINPUT 
(See tables 4.10 and 4.11 for other register values) 


On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 
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SF_INIT (AX = 0200H) 


This subfunction initializes the driver. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__INIT (OOH) 
BP = V__SINPUT (002AH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__DEF_LINKS (AX = 0400H) 
This subfunction sets the parent vectors in the HP-HIL physical device driver headers to their 


system defaults. The defaults are shown in table 4.16. The child vector entries are set to the null 
device driver (V__PNULL) by default (see Appendix F). 


Table 4.16 


Default Physical Device Driver Parents 


Keyboard V__8041 
Mouse V__ PGID__CCP 
Tablet V__LTABLET 
Touch Screen V__LTOUCH 
Barcode Reader V__PNULL 


Rotary Knob V__PGID__CCP 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__DEF__LINKS (OOH) 
BP = V__SINPUT (002AH) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF_GET_LINKS (AX = 0402H) 
This subfunction returns the current parent and child vectors in the HP-HIL physical device driver 


headers. The address of a seven word (14 byte) table is passed to the subfunction. When the 
subfunction returns, the buffer will contain the current vectors. See table 4.17 for the buffer 


format. ~ 


Table 4.17 


Mapping Buffer Format 


Word Parent Vector Child Vector HP-HIL Device 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__GET__LINKS (02h) 
BP = V__SINPUT (002AH) 
ES:S| = Pointer to table 


On Exit: AH = Return Status Code 
ES:S| = Pointer to table 


Registers Altered: AX, BP, DS 


SF_SET_ LINKS (AX = 0404H) 
This subfunction sets the parent and child vectors in the HP-HIL physical device driver headers. 


The address of a seven word (14 byte) table is passed to the subfunction. The table contains the 
new parent and child vectors for the drivers. The format of the buffer is shown in table 4.17. a 
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On Entry: AH 
AL 

BP 

ES:SI 

On Exit: AH 


F_ IO__CONTROL (04H) 
SF__SET__LINKS (04H) 
V__SINPUT (O02AH) 
Pointer to table 


Return Status Code 


Registers Altered: AX, BP, DS 


The following example is how to use the SF__SET__LINKS function. It is presumed that a call to 
F__INQUIRE__ALL has been made, and that the device at address #3, is a tablet. The tablet is 
going to be mapped to the V_.LHPMOUSE driver. The BX register already has the offset into the 
buffer of tablet mappings. 


BUFFER 


MOV 


POP 
F__INQUIRE 


DW _ 7 DUP (?) 


CX, BUFFER[BX] 


; get the current mapping of 


' the tablet 


CH, V_LHPMOUSE/6_ - 


BUFFER[BX], CX 
AH, F_JO__CONTROL 
AL, SF__SET__LINKS 


BP, V__SINPUT 

SI BUFFER ; 
DS 

ES 

DS 

HP__ENTRY 

DS 

(AH = 06H) 


change tablet to HP Mouse 


; Save the new mapping 

; load function code 

, load subfunction code 

/ load vector address 

' get the offset of the buffer 


: ES = DS 
;, save current DS 
; call extended BIOS driver 


This function returns a pointer to the Physical Describe Record of the specified HP-HIL physical 
device driver. WARNING: THE PHYSICAL DESCRIBE RECORD SHOULD NOT BE MODIFIED IN ANY 


WAY. 


On Entry: 


On Exit: 
ES:Sl 


F__INQUIRE (O6H) 


HP-HIL Device Number (1 — 7) 


V__SINPUT (002AH) 


Return Status Code 


Pointer to Physical Describe Record 


Registers Altered: AX, BP, SI, DS, ES 
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F_ INQUIRE__ALL (AH = 08H) 

This subfunction is used to determine which HP-HIL devices are present on the loop. The address 
of a seven word table is passed to the subfunction. When the subfunction returns, the table will 
contain the current status of all HP-HIL devices. The format of the buffer is shown in table 4.18. 


Table 4.18 


Device Inquire Buffer Format 


HP-HIL 
Word Device ID Device Status* HP-HIL Device 


Device #1 


tt rr 


* BitO = 1 if device present, 0 if no device at this address. 
Bits 2 — 7 are reserved. 


On Entry: AH = F_INQUIRE_ALL (08H) 
BP = V__SINPUT (002AH) 
ES:S| = Pointer to table 


On Exit: AH = Return Status Code 
ES:SI| = Pointer to table 


Registers Altered: AX, BP, DS 
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The following example shows how to use the F__INQUIRE__ALL function. 


BUFFER DW _ 7 DUP(?) 


MOV AH, F__INQUIRE__ALL , load function code 
LEA S|. BUFFER , get offset of buffer 
PUSH DS 

POP ES “ES = DS 

PUSH DS ; save current DS 
INT HP__ENTRY , call EX-BIOS driver 
POP DS ' restore DS 


~ 


F_ INQUIRE__FIRST (AH = OAH) 


This function returns the vector address of the first HP-HIL physical device driver (HP-HIL address | 
1). This address allows the vector address of all HP-HIL physical device drivers to be easily 
calculated since the vectors are contiguous in the HP_.VECTOR__TABLE (see table 4.19). 


On Entry: AH = F__INQUIRE__FIRST (OAH) 
BP = V__SINPUT (002AH) 
On Exit! AH = Return Status Code 
BX = Vector address of first HP-HIL physical device driver 


Registers Altered: AX, BX, BP, DS 


F_REPORT_ENTRY (AH = OCH) 


This function is used to get the CS:IP of the physical GID driver. 


On Entry: AH = F__REPORT__ENTRY (OCH) 
BP = V__SINPUT (002AH) 

On Exit! AH = Return Status Code 
BX = offset of physical GID driver 
ES = segment of physical GID driver 


Registers Altered: AX, BX, BP, DS, ES 
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4.3.3.4 Physical GID Driver 


The physical GID driver is responsible for updating the Physical Describe Record. Two types of 
graphics input devices are defined in the input system, absolute (touch screen and tablet), and 
relative (mouse). An instance of this driver (Same code module, different data area) is installed for 
each graphic input device present. 


A summary of the PGID function codes is provided in table 4.19. 


Table 4.19 


Physical GID Driver Function Code Summary 


Vector Func. Function 
Address Value Equate Definition 


HP-HIL driver vector 1 through Physical HP-HIL driver vectors (these 
HP-HIL driver vector 7. vectors do not have fixed 
HP__VECTOR__TABLE addresses) 


F__ISR Logical Interrupt 


F_ SYSTEM System functions 
SF__INIT Initialize driver 
SF__START Start driver 
SF__REPORT__STATE Unsupported 
SF__VERSION__DESC Report HP version number 


Physical GID Driver Function Definitions 


F_ISR (AH = OOH) 


This function processes ISR Event Records, updates the fields in its Physical Describe Record, then 
calls its parent driver. HP-HIL devices report upward relative motion with a positive sign and 
downward relative motion with a negative sign. The industry standard representation is the 
opposite of this. 


126 Input System and HP-HIL 


On Entry: AH = F__ISR (OOH) 
DH = Data Type 
DL = Physical device driver's vector address / 6 
BP = HP-HIL device n vector address 


For Button Event: 


BX = Button information. 


Bit Value Definition 
OFH-08H —— Reserved 
07H 1 Button up 

0 Button down 
O6H-OOH ——— Button number (0-7) 


For Motion Event: 


BX = X axis motion in raw data form. 
CX = Y axis motion in raw data form. 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_INIT (AX = 0200H) 


This subfunction is called to initialize the driver. 


On Entry: AH = F__SYSTEM (02H) 

AL = SF__INIT (OOH) 

BP = HP-HIL device n vector address 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF_START (AX = 0202H) 


This subfunction starts the driver. 


On Entry: AH = F__SYSTEM (02H) 

AL = SF__START (02H) 

BP = HP-HIL device n vector address 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = HP-HIL device n vector address 
On Exit: AH = Return status code 
BX = Release date code 
CX = Number of byte in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


4.3.3.5 V__PNULL Driver (BP = 000CH) 


The null device driver is the default event driver routine. It is used when the physical device is not 
recognized or the user event handler is not installed. It sets the AH register to RS__SUCCESSFUL 
and does an IRET. 
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4.3.4 Hardware Interface Level Services 


Service drivers are provided as useful subroutines available to any driver. Currently the hardware 
interface level has only one service, the tracking sprite, V_STRACK. (For more information on 
sprites see Section 6). 


4.3.4.1 V__STRACK Driver (BP = 0005AH) 


V__STRACK is called by the logical GID drivers to move the graphics cursor (sprite) on the display 
screen. V__STRACK provides functions that allow the parameters of the sprite to be defined, and 
move the sprite around the display. 


A summary of the V__STRACK function codes Is provided in table 4.20. 


Table 4.20 


V__STRACK Driver Function Code Summary 


Vector Func. Function 
Address Value Equate Definition 


OOSAH V__ STRACK Sprite control 


OOSAH 02 F__SYSTEM System functions 
OO5AH 02/00 SF__INIT Initialize driver 
OOSAH 02/02 SF__ START Start driver 


F__ TRACK __INIT Sets tracking to default state 
F__TRACK__ON Enables tracking 
F__TRACK__OFF Disables tracking 
F__DEF__MASKS Define sprite masks 
F__SET__LIMITS__X Set max/min horizontal values 
F__SET__LIMITS__Y Set max/min vertical values 
F__PUT__SPRITE Display sprite 
F__REMOVE__SPRITE |= Remove sprite from display 
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V__ STACK Driver Function Definitions 


F_ISR (AH = OOH) 


This function Is called to move the sprite to a new location. The display under the sprite is | 
restored, and the sprite is redisplayed in its new location. The hot spot of the sprite is piacca at 
the coordinates passed in BX and CX. 


On Entry: AH = F_ISR (OOH) 
BX = X coordinate of sprite 
CX = Y coordinate of sprite 
DL = Source vector index 
BP = V__STRACK (O05AH) 
On Exit! AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Section 9 for a complete discussion of “~ 
the protocol utilized in data space allocation (‘‘last used DS" passed in register BX). 
On Entry: AH = F__SYSTEM (02H) 
AL = SF_INIT (OOH) 
BX = “Last used DS” in HP Data Area 
BP = V__STRACK (005AH) 
On Exit: AH = Return Status Code 
BX = New ‘last used DS” in HP Data Area 
Registers Altered: AX, BX, BP, DS 
SF_START (AX = 0202H) 
This subfunction is called to start the tracking driver. —_ 
On Entry: AH = F__SYSTEM (02h) 
AL = SF__START (02H) 
BP = V__STRACK (005AH) 
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On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F_TRACK_INIT (AH = 04H) 


This function sets the tracking driver to its default state. It determines the current video mode, 
and initializes the tracking parameters. 


On Entry: AH 
BP 


F__TRACK__INIT (04H) 
V__ STRACK (O05AH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F_TRACK__ON (AH = 06H) 
This function enables tracking. The sprite is displayed on the screen. 


On Entry: AH 
BP 


F__TRACK__ON (06H) 
V__STRACK (005AH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F_TRACK__OFF (AH = 08H) 
This function disables tracking. The sprite is removed from the screen. 


On Entry: AH 
BP 


F__TRACK__OFF (08H) 
V__ STRACK (OO5AH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


Input System and HP-HIL 131 


F_DEF_MASKS (AH = OAH) 


This function is called to define the sprite and screen masks used by the driver. If tracking Is 
enabled, the sprite is erased and the new sprite is displayed in its place. The size of the sprite (its 
width in bytes multiplied by its height) is limited to a total of 144 bytes. The width of the save 


area Is one byte greater than the width of the sprite. 


On Entry: AH 


On Exit: 


AH 


F__DEF__MASKS (OAH) 


Width of the save area (in bytes) 


Hot Spot X coordinate 
Height of sprite (in scan lines) 
Hot Spot Y coordinate 
V__STRACK (005AH) 

Pointer to sprite mask 


Return Status Code 


Registers Altered: AX, BP, DS 


The following example shows how to use the F_DEF__MASKS function provided by the tracking 


driver. 


SPRITE 


OFOFFH 
OFOFFH 
OEO/7FH 
OEO7FH 
OCO3FH 
OCO3FH 
O801FH 
O801FH 
OOOOFH 
OOOOFH 
OFOFFH 
OFOFFH 
OFOFFH 
OFOFFH 
OFOFFH 
OFOFFH 


Define the XOR mask 
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~ 


~ 


~ 


- 77717001717111171911 
* 71717110*0017111111 
' 17100000011117171717 


; 1110000001111111 


~ 


~ 


~ 


~ 


~ 


* 71700000000111111 
* 11000000001111171 
* 7000000000011111 
* 70000000000111771 
* 0000000000001117 


, O0000000000001111 
, 177117100001771717171717 
, 711711000011171711111 


~ 


~ 


~ 


~ 


‘ 7717700001717111117 
' 71171170000171111117111 
' 71771000017117117171177 
- 71717100001771171171 


'™*!’ marks the 
Hot Spot 


MOV 


LEA 


PUSH 


POP 


MOV 
MOV 


MOV 
MOV 
MOV 
PUSH 


INT 
POP 


F_ SET__ 


AH, F__DEF__MASKS 


OOO00H 
OO600H 
OOFOOH 
OOFOOH 
O1F80H 
O1F80H 
O3FCOH 
O3FCOH 
O7FEOH 
O0600H 
O0600H 
O0600H 
O0600H 
QOO0600H 
O0600H 
QOO00H 


SI, SPRITE 


DS 
ES 


CH, 10H 


BH, 3 


BL, 5 
Chef 


BP, V_STRACK 


DS 


HP__ENTRY 


DS 


~ 


~ 


* OODOOODD00000000 
* 00000* 1000000000 
* 0000111100000000 
‘ 0000111100000000 


0001111110000000 
0001111110000000 
0011111111000000 


‘ 0011111111000000 
* 0111111111100000 
* 000001 1000000000 
‘ 000001 1000000000 
* 000001 1000000000 
* 000001 1000000000 
* 000001 1000000000 
‘ 000001 1000000000 
* OOOOODOO00000000 


"*!’ marks the 
Hot Spot 


; load function code 


~ 


~ 


- get the offset of the sprite 


‘ ES = DS of sprite 
; height of sprite 


;, number of bytes wide the 


; Save area Is 
; hot spot x 
; hot spot y 


; load vector address 


~ . 


save current DS 


; call EX-BIOS DRIVER 


restore DS 


- e 


LIMITS_% (AH = OCH) 


This function sets the minimum and maximum horizontal position of the sprite on the screen. 
The default minimum and maximum values are the same as the current screen mode. 


On Entry: AH 


CX 
DX 
BP 


F__SET__LIMITS__X (OCH) 
Minimum X coordinate 
Maximum X coordinate 
V__ STRACK (O05AH) 
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On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F_SET_ LIMITS_Y (AH = OEH) 


This function sets the minimum and maximum vertical position of the sprite on the screen. The 
default minimum and maximum values are the same as the current screen mode. 


On Entry: AH = F_SET__LIMITS__Y (OEH) 
CX = Minimum Y coordinate 
DX = Maximum Y coordinate 
BP = V__STRACK (005AH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F_PUT_ SPRITE (AH = 10H) 


This function is called to put the sprite on the display. 


On Entry: AH = F__PUT__SPRITE (10H) 
BX = X coordinate of sprite 
CX = Y coordinate of sprite 
BP = V__STRACK (OO5Ah) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F_REMOVE__SPRITE (AH = 12H) 
This function removes the sprite from the display. 


On Entry: AH 
BP 


F__REMOVE__SPRITE (12H) 
V__ STRACK (005AH) 


On Exit: AH = Return Status Code. 


Registers Altered: AX, BP, DS 
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SECTION 5. KEYBOARD 


5.1 Overview 


The Keyboard Input System consists of four components: The input device drivers, STD-BIOS 
keyboard drivers, 8041 keyboard controller chip and the EX-BIOS keyboard drivers. The input 
device drivers are discussed in Section 4. The other three components are discussed in this 
section (See figure 5.1). 


The industry standard INT 16H and INT O9H handlers make up the STD-BIOS keyboard drivers. 
INT 16H is used by applications to get characters from the keyboard buffer. INT O9H responds to 
interrupts from the 8041 controller and places characters in the keyboard buffer. 


The 8041 controller chip provides an industry standard hardware interface to the INT OSH driver. 
It also provides timers and other services to the Keyboard Input System. 


The EX-BIOS drivers translate HP-HIL keyboard scancodes to industry standard scancodes. They 
also allow applications to redefine the scancodes generated by certain groups of keys on the 
keyboard (keypads). 


The following data flow describes the actions that occur when a user presses a key until it is read 
by an application: 


1. When a key is pressed on the keyboard, the input device driver V__HPHIL creates an ISR 
event and chains to the input device driver V__SINPUT. The input device driver V__SINPUT 
chains to the EX-BIOS logical keyboard driver. 


2. The EX-BIOS logical keyboard driver determines which keypad the scancode is from and 
calls the appropriate translator service. After translation, the logical keyboard driver chains 
to the 8041 interface driver. 


3. The 8041 interface driver (V__8041) sends the scancode to the 8041 controller chip. The 
8041 controller generates an Output Buffer Full (OBF) interrupt to notify the STD-BIOS INT 
O9H driver that a scancode is available. 

4. The STD-BIOS INT O9H driver reads the scancode from the 8041 chip. The scancode is 
placed in the STD-BIOS keyboard buffer along with its associated ASCII character (keycode). 
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Keyboard Block Diagram 


Standard Application Interface 


STD-BIOS Drivers 
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5. When an application is ready to receive keyboard input it calls the STD-BIOS INT 16H driver 
to retrieve the keycode and scancode from the STD-BIOS keyboard buffer. 


5.2 STD-BIOS Keyboard Drivers 


The STD-BIOS component consists of two drivers: the keyboard ISR routine (INT O9H), and the 
keyboard interface driver (INT 16H). The drivers discussed here cover steps 4 and 5 in the 
overview of Section 5. 


5.2.1 Overview 


The INT O9H driver responds to the 8041 OBF interrupt (generated by V__S8259) and reads in a 
scancode from the 8041 controller. If the scancode is from one of the keyboard modifier keys, 
the appropriate state bits are updated. The scancode is then placed in the STD-BIOS keyboard 
buffer along with its corresponding ASCII character (keycode) or a null byte (OH). 


The INT 16H driver provides functions to allow the application to interrogate and manipulate the 
keyboard input system. Applications may check for keycodes in the STD-BIOS keyboard buffer, 
remove keycodes from it, and retrieve the state of the keyboard modifiers. 


Extended functions are provided by the INT 16H driver to give the application additional control 
over the keyboard and to facilitate keyboard driver mapping. Extended functions allow the 
application to turn off or change the default translations performed on the HP Softkeys and 
Cursor Control keypads (see figure 5.2). Applications may inquire about and/or change the 
typematic rate and delay values for the keyboard. Functions are also provided to aid applications 
wishing to install keypad translator services of their own. 


5.2.2 Data Structures 


The INT 16H and INT O9H driver data structures are located in the STD-BIOS data area. They are 
stored in memory addresses 417H (40:17H) through 43DH (40:3DH). Table 5.1 lists these 
memory locations and their definitions. 
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Figure 5.2 


Table 5.1 
STD-BIOS Keyboard Driver Data Area 


Length 
Address Bytes Definition 


00417H Keyboard Flags 


00419H Alt/Numpad accumulator 
O041AH Keyboard buffer head pointer 
0041CH Keyboard buffer tail pointer 
O041EH Keyboard buffer 
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The keyboard buffer can store up to 16 entries. Each buffer entry consists of two bytes; an ASCII 
character (keycode) and a scancode. The keycode and the scancode are placed in the keyboard 
buffer by the INT O9H driver, and the keyboard head pointer is adjusted accordingly. They are 
retrieved from the buffer by the INT 16H driver, and the keyboard tail pointer is adjusted. 


The keyboard flags are maintained by the INT O9H driver. These flags indicate the state of the 

keyboard modifier keys and their respective modes. The byte at memory location 417H indicates 
the mode, while the byte at 418H reflects the actual state of the keys themselves. Tables 5.2 and 
5.3 list these flags and their meaning. 


Table 5.2 


Keyboard Flags (Address 417H) 


00417H 07H 
O6H 
O5H 
O4H 
O3H 
O2H 
O1H 
OOH 


Address Bit Data Definition 


Insert state 

Insert mode Is active 
Caps lock state 

Caps lock mode is active 
Num lock state 

Num lock mode Is active 
Scroll lock state 

Scroll lock mode is active 
<Alt> key State 
<Alt> key Is pressed 
<CTRL> key State 
<CTRL> key is pressed 
Left <Shift> key state 


Left <Shift> key is pressed 


Right <Shift> key state 


Right <Shift> key pressed 
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Table 5.3 
Keyboard Flags (Address 418H) 


00418H 07H <Ins> key state 
<Ins> key is pressed 
O6H <Caps lock> key state 
<Caps lock > key is pressed 
OSH <Num lock> key state 
<Num lock> key is pressed 
O4H <ScrLck> key state 
<ScrLck> key is pressed 
O3H Pause State 
Indicates the <CTRL>-<Num lock> pause 
state Is active 
02H <Sys req> key state 
< Sys req> key Is pressed 
01H-OOH Reserved 


Note: 


Applications which modify these two bytes may experience ‘difficulty in maintaining 
synchronization between the Cursor Control keypad and the Numeric keypad. 


5.2.3 STD-BIOS Keyboard ISR (INT 09H) 


The keyboard interrupt service routine is responsible for retrieving scancodes from the 8041 
controller, generating the associated keycodes, and placing them into the STD-BIOS keyboard 
buffer. Certain keys and key combinations do not generate a standard ASCII character code. In 
these cases a keycode equal to 0 indicates that an application program should examine the 
scancode byte to determine the “‘extended”’ ASCII code. Table 5.4 contains the scancode to 
keycode translation assignments. 
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Table 5.4 


Scancode Conversion Table 


Key AT Hp Unshifted Shifted 
, Number Scancode Scancode Key Cap ASCIl Hex ASCII Hex Control Alt 


Mm 
Ta) 
C) 
MO 
W 
(a) 


~ 


00/78H 
00/79H 
GO/7AH 
00/7BH 


00/7CH 
00/70DH 
00/7EH 
_ O0/7FH 
< 00/80H 
) 


~ 


~~ 


00/81H 
00/82H 
00/83H 


T | OL/WONDMNARWN—> 
CLOWN QU) RWN 


odAD 
mw @ 
on 
om af ~ 
oO | 
on 


Q 00/10H 
W 00/11H 
E 00/12H 
'R’ 00/13H 
Te 

Y 

U 

| 


00/14H 


00/15H 
00/16H 
00/17H 
00/18H 
00/19H 


eee Cae 4IamMsO 
oO 6 Sl =m S10 


—_ 
~ ~~ 
mean | xs 
~~ ~ as ee ~ 


PAS 
—“— - 


~ 


2] rw RAY] m 


A 

S 00/1FH 
D 00/20H 
F’ 00/21H 
G' 00/22H 
H’ 00/23H 
J 00/24H 
K 00/25H 
L 00/26H 
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Key 
Number 
14 


46 
47 


Key 
Number 


105 
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AT 


Hp 


Scancode Scancode Key Cap 


O5DH 
O1AH 
O22eH 


O21H 
O2AH 
032H 
031H 
O3AH 


041H 
O49H 
O4AH 
O59H 
O7CH 


O011H 
O29H 
O58H 
OO5H 
O06H 


O04H 
OOCH 
003H 
OOBH 
083H 


OOAH 
O001H 
OO9H 


AT 


O2BH 
O2CH 
O2DH 


O2EH 
O2FH 
O30H 
031H 
O32H 


033H 
O34H 
O35H 
O36H 
037H 


038H 
O39H 
O3AH 
O3BH 
O3CH 


O3DH 
O3EH 
O3FH 
O40H 
041H 


O42eH 
043H 
O44H 


Hp 


\ 


Z 
X 


C 
V 
B 
N 
M 


/ 

Right Shift 
Prt Sc 

Alt 

Space 
Caps lock 
F 1 

F2 


F8 
F9 
F10 


Scancode Scancode Key Cap 


O84H 


O54H 


Num lock 
ScrLck 
Home 


Pg Up 


Sysreq 


Unshifted 


ASCIl Hex 


Shifted 
ASCIl 


bee SCH ai? 


'Z 
‘x 
C 
v’ 


b 


, 
‘ 
‘ 
! 
Uy 
Uy 


i 


mM 


UU 
i 


7 


NumLock 


or 
Shift 


Cor! | 


~- 
- 


~ 


PRU 


~ 


~ ~ ~ ~ 
".OWN> 
~ ~ ~ 


(AH 
78H 


j 


é 


U 


Z 
X 
C 
\V' 
B 
N 
: 


f 

‘ 

‘ 
M1’ 
i ‘ 
< 
‘ ‘ 
> 
is! 


Hex 


(CH 
SAH 
58H 


43H 
56H 
42H 
4EH 
4DH 


20H 


54H 
SSH 


56H 
57H 
58H 
39H 
SAH 
5 BH 
SCH 
SDH 


None Or 
NumLock 
and Shift 


00/47H 
00/48H 
00/49H 


3AH 
00/4BH 


00/4DH 
2BH 


O0/4FH 
00/50H 
00/51H 
00/52H 
00/53H 


Control 


1CH 
1AH 
18H 


O3H 
16H 
O2H 
OEH 
ODH 


20H 


O0/5EH 
O0O/SFH 
00/60H 
00/61H 
00/62H 
00/63H 
00/64H 
00/65H 
00/66H 
00/67H 


Control 


0077H 
00/84H 


00/73H 
00/74H 


00/75H 
00/76H 


Alt 


00/2cH 
00/204 


O00/2EH 
O00/2FH 
00/30H 
00/31H 
00/32H 


20H 
00/68H 
00/69H 


00/6AH 
00/6BH 
00/6CH 
00/6DH 
00/6EH 
O0/6FH 
00/70H 
00/71H 


, 


Key AT Hp Unshifted Shifted 
Number Scancode Scancode Key Cap ASCII Hex ASCIl Hex Control Alt 


- undef. 
O5BH - undef. 
- undef. 
- undef. 
Unlabled-L O0O/D7H O0/BDH OO/A3H OO0O/89H 


Unlabled-R OQ/D8H O0/BEH OO/A4H OO0/8AH 
113 O60H CCP-Up 00/D9H O0/BFH O00/A5H OQ/8BH 
111 061H CCP-Lft O0/DAH O00/COH O0/A6H OO0/8CH 
CCP-Dn O0/DBH O00/C1H 00/A7H OO/8DH 
CCP-Rht O0/DCH O00/C2H O00/A8H OO/8EH 


CCP-Home OQQ/DDH 00/C3H OO/A9H OO/8FH 
117 O65H CCP-PgUp OQOQ/DEH 00/C4H OO/AAH OO/90H 
112 O66H CCP-End O0O/DFH O0/C5H OO/ABH OO/91H 
119 067H CCP-PgDn OQOOQ/EOH 00/C6H OO/ACH OO0/92H 
116 O68H CCP-Ins 00/E1H 00/C7H OO/ADH O00/93H 


CCP-Del O0/E2H 00/C8H OO/AEH O0/94H 
114 O6AH CCP-CNTR OO/E3H 00/C9H OO/AFH OO/95H 

O6BH - undef. 00/E4H O0/CAH 00/BOH O0/96H 
- undef. O0/E5H 00/CBH 00/B1H QO0O/97H 
- undef. 00/E6H O0/CCH 00/B2H O00/98H 


00/E7H O0/CDH 00/B3H O0/99H 

O6FH - undef. 00/E8H O00/CEH 00/B4H OO0/9AH 
121 O70H f1 00/E9H OO/CFH 00/B5H OO0/9BH 
OO/EAH 00/D0H O0/B6H O0/9CH 
O0/EBH 00/01H O0/B7H QO/9DH 


O0/ECH 00/D2H 00/B8H O0/9EH 
125 O74H f5 O0/EDH 00/D3H 00/B9H O0/9FH 
126 O75H f6 O0O/EEH 00/D4H OO/BAH OQO/AQH 
I27 O76H f7 OO/EFH 00/D5H O0/BBH OQ/A1H 
128 O77H f8 00/FOH O0/D6H O0/BCH OO/A2H 


O78H through 7FH—undef. 


The INT O9H driver tracks the state of the keyboard modifiers presented in tables 5.2 and 5.3 as 
well as processing the special key combinations in table 5.5. 
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Table 5.5 


INT O9H Special Key Sequences 


Key Combinations 
<CTRL>-<Num lock> 


<CTRL>-<Alt>-< +> 


<CTRL>-<Alt>-<-> 


<CTRL>-< Break> 


<CTRL>-<Alt>-<DEL> 


< Shift >-< Prt Sc> 


< Sys req > 
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Action 


Stops execution until any non-shift key on the 
keyboard Is struck. 


This key sequence enables the key click feature. The 
longer the <CTRL>-<Alt>-< + > keys are pressed, 
the louder the key click that will result. After maximum 
volume Is achieved the key click volume will wrap 
around to low volume. Applications which depend 
upon datacom rates at and above 9600 baud while 
keyboard Input is being entered should disable the 
keyclick feature. 


This key sequence reduces the key click volume until it 
is off. 


This key combination ts interpreted as a program break 


request. When this key combination is detected, the 
INT OSH driver will execute an INT 1BH instruction. The 
vector for this interrupt Is initialized during the boot 
process to point to a routine within MS-DOS which 
sets a flag then performs an IRET instruction. This 
vector may be modified to point to an alternate 
routine to handle a <CTRL>-<Break>. 


This key combination ts interpreted as a system reset 
command. When this key combination Is detected, 
control is transferred to the BIOS Reset routine. 

This key combination is interpreted as a print screen 
command. When this key combination is detected, an 
INT O5H instruction is executed. 


This key is interpreted as a system request for multi- 
tasking. 


Key Combinations 


<CTRL>-<Alt>-<Sys req> This key sequence provides the user with a method of 
generating a hard reset sequence. The key sequence Is 
communicated to the ROM-BIOS via a non-maskable 
interrupt (NMI) to the 80286. This key sequence does 
not require the HP-HIL firmware interface to be 
operational. The key sequence Is used to recover from 
exceptional error conditions without power cycling the 
system. The EX-BIOS code then: 


1) Inspects for the source of the NMI (either I/O 
channel check, Memory Parity Error, or as in this 
case NMI-RESET). 

2) Clears CMOS location 28H, 29H, 2AH, and 2CH to 
its default setting. 

3) Jumps to location FOOOH:FFFEH. 


<ALT>-nnn Where nnn represents a three digit decimal number 
entered on the numeric keypad and yields the 
associated ASCII characters, i.e., <ALT>-122 yields 
the character “2”. 


5.2.4 STD-BIOS Keyboard Driver (INT 16H) 


The INT 16H driver acts as the interface between applications and the keyboard. This driver has 
two sets of functions. One set provides functions to return keycodes and keyboard status. The 
other set of functions allows the application to change the translation algorithms of the 
scancodes and to vary the repeat rates of the keys on the keyboard. Table 5.6 contains a 
summary of this driver's function codes. 
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Table 5.6 


Keyboard Driver (INT 16H) Function Code Summary 


Int 
Hex 


Function 
Value 


Function 
Equate 


INT__KBD 
F16__GET__KEY 
F16__ STATUS 
F16__KEY__STATE 


F16__INQUIRE 
F16__DEF__ATTR 


F16__GET__ATTR 
F16__SET__ATTR 
F16__DEF__MAPPING 


F16__GET__MAPPING 
F16__SET__MAPPING 
F16__SET__XLATORS 
F16__KBD 
F16__KBD__RESET 


6FO5H 
6FO6H 
6FO7H 
6FO8H 
6FO9H 


Definition 


Keyboard 

Read keycode from keyboard buffer 
Report Status of keyboard buffer 
Get Key Modifier Status 


EX-BIOS present 

Report default typematic values 
Report typematic values 

Set typematic values 

Report default transfer assignments 


Report transfer assignments 
Set transfer assignments 

Set CCP and softkey pads 
Report keyboard information 
Reset keyboard to defaults 


Keyboard Driver (INT 16H) Function Definitions 


F16_ GET_KEY (AH = OOH) 


This function returns the next keycode from the keyboard buffer. If no keycode is ready, this 
function waits for one. 


On Entry: AH = F16__GET__KEY (00H) 
On Exit: AH = Scancode 
AL = ASCII keycode or extended keycode 


Registers Altered: AX 
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F16_ STATUS (AH = 01H) 


This function returns the status of the keyboard buffer. The Zero flag is cleared if a keycode is 
available, or set if there is no keycode in the buffer. If a keycode is ready, the scancode and 
keycode are returned in the AH and AL registers respectively. Even though the scancode and 
keycode are returned with this function, they must be read with F16__GET__KEY to remove 
them from the keyboard buffer. 


On Entry: AH = F16__STATUS (01H) 


On Exit: Z = 1 if no keycode is ready. 
Z = O'fa keycode is ready. 
and 
AH = Scancode 
AL = Keycode or extended keycode. 


Registers Altered: AX 


F16_ KEY. STATE (AH = 02H) 


This function returns the state of the various keyboard modifiers. The status byte returned is a 
copy of the keyboard modifier status byte stored at memory location 417H. 


On Entry: AH = F16__KEY__STATE (02H) 
On Exit: AL = Modifier Status Byte 


Bit Data Definition 
07H 1 Insert mode active 

0 Insert mode inactive 
O6H 1 Caps lock mode active 

0 Caps lock mode inactive 
O5H 1 Num lock mode active 

0 Num lock mode inactive 
04H 1 Scroll lock mode active 

0 Scroll lock mode inactive 
03H 1 <Alt> key pressed 

0 <Alt> key released 
O2H 1 <CTRL> key pressed 

0 <CTRL> key released 
O1H 1 Left <Shift> key pressed 

0 Left <Shift> key released 
OOH 1 Right <Shift> key pressed 

0 Right <Shift> key pressed 


Registers Altered: AL 


Keyboard 149 


F16_ INQUIRE (AX = 6F00H) 


This subfunction determines whether or not the extended HP functions are available. If the HP 
functions are available, the BX register will be set to 4850H (which is the ASCII characters ‘HP’). 


On Entry: AX = F16__INQUIRE (6FOOH) 
BX = Any value except 4850H, ‘HP’. 
On Exit: BX = ‘HP’ 


Registers Altered: BX 


F16__DEF_ATTR (AX = 6F01H) 


This subfunction reports the default typematic rate and delay values for the keyboard. A pointer 
to a four byte buffer is returned. The bytes in the buffer are defined in table 5.7. 


Table 5.7 


INT 16H Typematic Buffer Format 


Byte Function 


Delay before repeat action starts for all keys, except the Cursor Control Pad. 
Typematic Repeat rate for all keys, except the Cursor Control Pad. 

Delay before repeat action starts for all Cursor Control Pad keys. 

Typematic Repeat rate for all Cursor Control Pad keys. 


WN — © 


Table 5.8 summarizes the typematic rate and delay values defined for each data byte accepted in 
the typematic buffer by the INT 16H driver. Note that the typematic rates are the same for both 
the HP cursor control pad and the non-cursor pad keys while two delay values are provided (one 
for each group). 
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Table 5.8 


INT 16H Typematic Rates and Delays 


Byte 1 and 3 Byte 2 Byte 0 
Reports Number of Number of 
Data Byte per Poll* Polls Delayed** Polis Delayed 


[0.017] [0.017] 


*Numbers in parentheses ( ) indicate the approximate number of repeated scancodes per 
second (assuming a poll rate of 60 cycles per second). 


**Numbers in brackets [ ] indicate the approximate length of delay prior to the first repeated 
scancode report (assuming a poll rate of 60 cycles per second). 


On Entry: AX = F16__DEF_ATTR (6F01H) 
On Exit: | AH = OOH (Successful operation) 
ES:S| = Pointer to buffer 
CX = 4 (Number of entries in table) 


Registers Altered: AX, CX, SI, ES 
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F16_ GET_ATTR (AX = 6F02H) 


This subfunction reports the current typematic rate and delay values for the keyboard. A pointer 
to a four byte buffer is returned. The bytes in the buffer are interpreted as shown in table 5.7 
and 5.8. 


On Entry: AX = F16__GET__ATTR (6F02H) 
On Exit: . AH = OOH (Successful operation) 
ES:S| = Pointer to buffer 
CX = 4(Number of entries in table) 


Registers Altered: AX, CX, SI, ES 


F16_SET_ATTR (AX = 6F03H) 


This subfunction sets the current typematic rate and delay values for the keyboard. A pointer to a 
four byte buffer is passed. The bytes in the buffer are interpreted as shown in table 5.7 and 5.8. 


On Entry: AX = F16__SET__ATTR (6F03H) 
ES:S| = Pointer to buffer 


On Exit: | AH = OOH (Successful operation) 


Registers Altered: AX 


F16_ DEF_MAPPING (AX = 6F04H) 


This subfunction reports the default keyboard translator mappings. A pointer to a buffer of 1EH 
bytes is supplied by the caller to be filled in by the ROM-BIOS. The table will contain the default 
HP__VECTOR__TABLE entries for each of the five translator drivers. Each of five entries in the 
table will contain the IP, CS, and DS for each translator driver. 


Caution 


An application should restore the translator drivers to their original condition upon 
termination. If an application replaces one of these drivers it should be aware that 
STD-BIOS keyboard driver functions 6FO7H may no longer function properly. 


The format of the buffer is given in table 5.9. 
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Table 5.9 


INT 16H Mapping Buffer Format 


Byte Translator 


OOH Entry for V__QWERTY driver 
O6H Entry for V__SOFTKEY driver 


OCH Entry for V__FUNCTION driver 
12H Entry for V_.NUMPAD driver 
18H Entry for V__CCP driver 


On Entry: AX = F16__DEF__MAPPING (6F04H) 
ES:S| = Pointer to buffer 
On Exit: © AH = OOH (Successful) 
ES:S| = Pointer to buffer of 1EH bytes 
CX = 1E£H (Size of buffer) 


Registers Altered: AX, CX 


F16__GET_MAPPING (AX = 6F05H) 


This subfunction reports the current keyboard translator mappings. A pointer to a buffer 1EH 
bytes in length is supplied by the caller to be filled in by the ROM-BIOS. The buffer will contain 
the current HP__.VECTOR__TABLE entries for each of the five translator drivers (IP, CS, and DS for 
each driver). The format of the buffer is given in table 5.9. 


On Entry: AX = F16__GET__MAPPING (6FO5H) 
ES:S| = Pointer to buffer 


On Exit: © AH = QOH (Successful) 
ES:S| = Pointer to buffer 
CX = 1EH (Size of table) 


Registers Altered: AX, CX 


F16_ SET_MAPPING (AX = 6F06H) 

This subfunction sets the current keyboard translator mappings. A pointer to a buffer containing 
the entries to be written into the HP__VECTOR__TABLE is passed in. The format of the buffer is 
given in table 5.9. 
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A driver that replaces a scancode translator can expect to handle a Keyboard ISR Event Record 
(table 5.10). If the translator wishes to remove the passed in scancode from the scancode 
stream, it returns a status of RS__DONE. Otherwise, a return status of RS__SUCCESSFUL should 
be set and an appropriate ISR EVENT record returned. The ISR Event Record will then be passed 
on to the next driver in the chain. The driver can depend on 20H bytes of stack. 


On Entry: AX = F16__SET__MAPPING (6F06H) 
ES:S| = Pointer to table. 
CX = 0O1EH (size of table in bytes) 
On Exit: AH = OOH (Successful) 


Registers Altered: AX 


F16__SET_XLATORS (AX = 6F07H) 

This subfunction sets the current mappings of the HP Softkey (V__SOFTKEY) and HP Cursor 
Control Pad (V__CCP) translators. Note that only one translator may be set with each call to this 
subfunction. Figure 5.1 shows the possible mappings for the two HP proprietary keypads. 


On Entry: AX = F16__SET__XLATORS (6F07H) 
BL = Translation 


Data Definition 


OOH Maps V__CCP to V__CCPCUR which forces the HP Cursor Pad to generate 


Numeric pad cursor key scancodes, regardless of state of <Num lock>. 
(Default mapping) 

O1H Maps V__CCP to V__CCPNUM which forces the HP Cursor Pad to generate 
numeric pad or cursor key scancodes, depending on state of <Num lock>. 

O2H Maps V__CCP to V__OFF which disables the HP Cursor Pad. 

03H Maps V__CCP to V__CCPGID (if installed) which converts HP Cursor Pad data 
to GID data. 

O4H Maps V__CCP to V__RAW which passes HP Cursor Pad scancodes 
untranslated to the INT O9H driver. 

OSH Maps V__SOFTKEY to V_SKEY2FKEY which translates HP Softkey scancodes 
into equivalent industry standard function key scancodes. (Default mapping) 

O6H Maps V__SOFTKEY to V_RAW which passes HP Softkey scancodes 
untranslated to INT O9H driver. 

O7H Maps V__SOFTKEY to V__OFF which disables HP Softkeys. 


On Exit: AH = OO (Successful) 


Registers Altered: AX 
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F16_ KBD (AX = 6F08H) 


This subfunction returns the HP-HIL ID and address of the keyboard. The HP-HIL address (BH) may 


be used to locate the logical keyboard driver in the HP__VECTOR_TABLE. The logical keyboard 
driver's vector address is: 


vector address = (BH—1) X 6 + rn 


Where n is the vector address of the first HP-HIL physical device driver (see Section 4, V__SINPUT 
function F__INQUIRE__FIRST. 


On Entry: AX = F16__KBD (6FO8H) 

On Exit: | AH = OOH (Successful) 
BH = HP-HIL Address 
BL = HP-HIL ID 


Registers Altered: AX, BX 


F16_ KBD__RESET (AX = 6FO9H) 


This subfunction resets all keyboard mappings to their default translators and resets all keyboard 
typematic rates and delays to their default values. 


On Entry: AX = F16__KBD__RESET (6FO9H) 
On Exit: © AH = OOH (Successful) 


Registers Altered: AX 


5.3 EX-BIOS Keyboard Drivers 


The rest of this section discusses keyboard information related to ISR events and ISR Event 
Records, device driver chains, and HP-HIL device data input; these concepts were introduced in 
Section 4. 
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5.3.1 Overview 


The EX-BIOS keyboard component consists of the logical keyboard driver, the keyboard translator 
services, and the V__8041 interface driver. The drivers discussed here cover steps 2 and 3 in the 
data flow of Section 5.1. 


5.3.1.1 Logical Keyboard Driver 


The logical keyboard driver is the primary interface for the physical keyboard and controls the 
process of scancode translation. Based on the keypad, the scancode is passed to one of five 
translator services: V_QWERTY, V__SOFTKEY, V__FUNCTION, V__CCP and V__NUMPAD. Figure 
5.2 shows the layout of the different keypad groups. This driver also maintains the state of the 
following keyboard modifier keys: <CTRL>, left and right <Shift>, <Alt>, <Caps lock>, 
and <Num lock>. This state information is passed to the V__CCP, V_.NUMPAD and 
V__QWERTY translator services. 


5.3.1.2 Keyboard Translators 


The keyboard translators act as subroutines for the logical keyboard driver. There are five 
translators corresponding to the keyboard keypads (see figure 5.2). The five translators are: 


V__QWERTY handles keys from the QWERTY keypad. 
V__ FUNCTION handles F1 thru F10 function keys. 
V__NUMPAD handles numeric or cursor pad keys. 
V__SOFTKEY handles HP’s f1 thru f8 softkeys. 
V__CCP handles HP’s cursor control pad. 


The translators for the HP softkeys and HP cursor control pad are special cases. 
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The V__SOFTKEY translator can translate its scancodes in the following ways: 


1. Map softkeys f1 thru f8 into function keys F1 thru F8 (V__SKEY2FKEY). 
2. Throw away f1 thru f8 softkeys (V__OFF). 
3. Pass back f1 thru f8 softkeys untranslated to the logical keyboard driver (V__RAW). 


The V__CCP translator can translate its scancodes in the following ways: 


. Map CCP keys to numeric keypad cursor control scancodes (V__CCPCUR). 

. Map CCP keys to numeric keypad scancodes (V__CCPNUIV). 

. Pass CCP keys as untranslated scancodes to the logical keyboard driver (V__RAW). 
. Throw away all CCP keys (V__OFF). 


HRWN > 


Functions are provided by the STD-BIOS INT 16H driver to select any of the above mappings. 


5.3.1.3 8041 Interface Driver 


The 8041 interface driver (V__8041) sends translated scancodes to the 8041 controller chip. If 
the 8041 controller is busy this driver queues the scancode to be sent later when the 8041 
controller is ready. In addition to passing scancodes from the keyboard to the 8041 controller, 


V__8041 processes keyboard controller commands to set keyboard LED’s and change keyboard 
typematic rates. 


5.3.2 Data Structures 


The EX-BIOS keyboard input system uses one data structure. The Keyboard ISR Event Record is a 
set of register definitions for inter-driver communication of input events. Table 5.10 contains the 
Keyboard ISR Event Record definition. 
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Table 5.10 
Keyboard ISR Event Record 


__ISR (OOH) 
Keyboard State (Only if state bit set in Data Type) 


Data Definition 

Left Unlabeled key pressed* 
Right Unlabeled key pressed* 
<Num lock> state active 
<Caps lock> state active 
<CTRL> key pressed 

Right <Shift> key pressed 
Left <Shift> key pressed 
<Alt> key pressed 


] 
1 
] 
1 
1 
] 
1 
] 


= Scancode 


Bit Data Definition 

O7H 1 Break indicator 
0 Make indicator 

O6H-OOH —  ~ Scancode 


Number of bytes in buffer (scancode strings only) 
Data Type 

Logical keyboard drivers vector address / 6 
HP-HIL device n vector address 

Pointer to buffer (scancode strings only) 


* These keys are located to the immediate left and right of the space bar. They are only available 
on some international keyboards. 


The Data Type field (DH) contains a code representing the current type of scancode contained in 

the ISR Event Record. When the logical keyboard driver calls a translator service, the Data Type 

will match the keypad group from which the scancode originated. After translation, the Data ~ 
Type for the ISR Event Record returned to the logical keyboard driver should be | 
T__KC__IBM__PC. See table 5.11 for a complete list of keyboard data types. 
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Table 5.11 


Keyboard Event Data Types 


Type Value Definition 


T__KC__RO Reserved 

T__KC_R1 Reserved 

T__KC__ ASCII ASCIl data 

T__KC__R3 Reserved 

T__KC_ITF HP150 keyboard (ITF) scancode 


T__KC__R5 OSH Reserved 

T_KC__WILD Q6H Device definable type 
T__KC__HPHIL_ENVOY O7H ~ HP Vectra Keyboard set 
T__KC__IBM__AT Q8H ~~ _IBM-AT scancode set 
T__KC__BUTTON O9H Button data type 


T__KC__IBM__PC IBM-PC scancode set 
T__KC__HP__SOFTKEY Softkey keypad (f1-f8) 
T_KC_IS__ FUNCTION Function key keypad (F1-F10) 
T__KC__HP__CCP HP Cursor Control Pad keypad 
T_KC__ QWERTY Qwerty keypad 
T__KC__NUMPAD Numeric keypad 


T__STRING This is not a data type but an indicator bit for the 
keyboard data types only. If bit 4 is set then the 
ISR Event record is for a string of scancodes 
pointed to by ES:SI and enumerated tn CX, i.e., 

OO x 1 ttttB 
indicates a string of data bytes of type defined by 
the lower nibble ‘tttt’. 

T_STATE This is not a data type but an indicator bit for the 
keyboard data types only. If bit 5 is set it indicates 
that the corresponding ISR Event record contains 
the current state in BH. 
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5.3.3 Logical Keyboard Driver 


The logical keyboard driver determines the keypad group the scancode belongs to and sets the 
Data type field in the ISR event record. Based on the Data type a translator service is called to 
handle the scancode. For example, If the ‘’Q’’ key scancode comes through, the logical keyboard 
driver determines the data type to be T_KC__QWERTY and calls the V_.QWERTY translator. If 
the translator called by the logical keyboard driver is responsible for any of the keyboard modifier 
keys the current state variable is placed in the ISR Event Record and the state indicator bit is set 
in the Data Type field. Table 5.12 contains the scancode range to translator service assignments. 


Table 5.12 


Scancode to Translator Assignments 


Driver Name  Scancode Range Translation Performed 


V__QWERTY OOH-36H None 
38H-3AH 
55H-5SFH 
6BH-6FH 
(8H-7FH 
V__SOFTKEY (OH-77H 3BH—42H (F1—F8) 
V_FUNCTION 3BH-44H None 
V__NUMPAD 37H, 45H-54H None 
V__CCP 60H-6AH Cursor Always—Regardless of state of the 


<Num lock> and <Shift> keys. 


If the translation was successful the returned ISR Event Record is passed to the logical keyboard 
drivers parent (V__8041). 


Before passing a successful translation to its parent (V__8041) the logical keyboard driver 
performs two conditional tasks. First, it checks the state bit in the returned Data Type, if set the 
master copy of the keyboard state variable is updated with the copy returned in the ISR Event 
Record. Second, if the ISR event went to the V__CCP translator the logical keyboard driver takes 
the necessary steps to insure that cursor control keys are generated regardless of the <num 
lock > and <shift> key states. 


lf a translator wants to remove the scancode from the scancode stream it must return a status 
code of RS__DONE to the logical keyboard driver (See the CCP2GID driver in Appendix G). 


Table 5.13 contains a summary of the logical keyboard driver functions. 
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Table 5.13 


Logical Keyboard Driver Function Code Summary 


Vector Func. Function 
Address Value Equate Definition 


00 
02 
02/00 SF__INIT Driver initialization 

02/06 SF__VERSION__DESC Reports HP version number 


Keyboard Driver (This driver does not have a fixed 
HP__VECTOR__TABLE address) 
F__ISR Logical Interrupt 
F__ SYSTEM System Intrinsics 


Logical Keyboard Driver Function Definitions 


F_ISR (AH = 00H) 


This function processes the Keyboard ISR Event Record. It determines the range of the scancode, 
then calls the appropriate translation service. 


On Entry: AH 


On Exit: AH 


F__ISR (OOH) 

Keyboard State (only if state bit set in Date type) 
Scancode 

Number of bytes in buffer (scancode strings only) 
Scancode type 

Vector address of keyboard / 6 

HP-HIL device n vector address 

Pointer to buffer (scancode strings only) 


Return Status Code 


Registers Altered: AX, BX, CX, DX, SI, BP, ES, DS 


SF_INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Section 9 for a complete discussion of 
the protocol utilized in data space allocation (“‘last used DS” passed in register BX). 
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On Entry: AH = F__SYSTEM (02H) 


AL = SF_INIT (OOH) 
BX = ‘‘Last used DS” in HP Data Area 
BP = HP-HIL device n vector address 
On Exit: AH = Return Status Code 
BX = New ‘last used DS” is HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = HP-HIL device n vector address 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


5.3.4 Keyboard Translators 


There is one keyboard translator service for each of the five keypad groups on the keyboard, see 
figure 5.2. Two of the five services are special cases in that they are actually chains of translators 
to facilitate keyboard mapping. Figure 5-1 shows the translators and their mapping possibilities. 


Applications may install routines to replace (or chain to) any one or all of the translators 
presented here. The INT 16H driver provides three functions to get the current 
HP__VECTOR__TABLE entries for the five keypad translators, to set these same values, and to 
reset them to their default values. The V__SYSTEM driver in Section 9 provides functions to get 
or set any fixed HP_.VECTOR_TABLE entry (all EX-BIOS translators presented in this section have 
fixed entries). The V__SYSTEM functions allow replacement of translators other than the main 
five called by the logical keyboard driver (those in translator chains). 
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Applications that do not wish to overlay existing translators, may install entirely new translators 
instead and map themselves into the HP Softkey and CCP translator chains as the parent drivers 
of the V__SOFTKEY and V__CCP services respectively. This method only works for the HP 
proprietary keypads. 


5.3.4.1 V__SOFTKEY (BP = 003CH) 


This translator service verifies the Data Type is T_KC__HP__SOFTKEY and then passes the ISR 
Event Record to its parent. By default this translator is mapped to the V__SKEY2FKEY service, 
alternative mappings are presented in table 5.14. 


Table 5.14 
V__SOFTKEY Driver Mapping Alternatives 


Driver Name Function 


\VV__OFF Discards the ISR event. 


V__RAW Returns the scancode untranslated. 
V__SKEY2FKEY _ Translates the HP Softkeys into their respective industry standard 
function key equivalents. 


F_ISR (AH = OOH) 


This function verifies the passed in Data Type and passes the ISR event on to its parent. 


On Entry: AH = F__ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC__HP__SOFTKEY = OBH) 
DL = Source vector address / 6 
BP = V__SOFTKEY (003CH) 
On Exit: AH = Return Status Code 
BL = Translated scancode 
BH = New keyboard state (only if state bit set in type) 
DH = New scancode type (T_KC__IBM__PC = OAH) 


Registers Altered: AX, BX, DH, BP, DS 
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SF_INIT (AX = 0200H) 


This subfunction Is called to initialize the driver. Refer to Section 9 for a complete discussion of 
the protocol utilized in data space allocation (‘last used DS’’ passed in register BX). 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__INIT (OOH) 
BX = ‘Last used DS” in HP Data Area 
BP = V__SOFTKEY (003Ch) 
On Exit: AH = Return Status Code 
BX = ‘New last used DS” in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06h) 
BP = V__SOFTKEY (003CH) 


On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, Dl, ES, BP, DS 


5.3.4.2 V__QWERTY (BP = 0036H) 


The V__QWERTY service verifies the correct Data Type. This service also maintains the state of 
the left and right <Shift> keys, the <CTRL> key, the <Alt> key, the left and right unlabeled 
keys and the <Caps lock > key. 
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F_ISR (AH = OOH) 


This function verifies the Data Type, updates the keyboard state variable, and returns. 


On Entry: AH = F__ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC__QWERTY = OEH) 
DL = Source vector address / 6 
BP = V__QWERTY (0036H) 
On Exit: AH = Return Status Code 
BH = New keyboard state (only if state bit set type) 
DH = New scancode type (T_KC__IBM__PC = OAh) 


Registers Altered: AX, BH, DH, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02h) 
AL = SF__VERSION__DESC (06H) 
BP = V__QWERTY (0036h) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


5.3.4.3, V__FUNCTION (BP = 0042H) 


This service verifies the Data Type, sets a new Data Type and returns. 


Keyboard 165 


F_ISR (AH = OOH) 


This function verifies the Data Type, and sets the new one. 


On Entry: AH = F_ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC_IS__ FUNCTION = OCH) 
DL = Source vector address 
BP = V__FUNCTION (0042H) 
On Exit: AH = Return status code 
DH = New scancode type (T_KC__IBM__PC = OAH) 


Registers Altered: AX, DH, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = V__FUNCTION (0042H) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


5.3.4.4 V_.NUMPAD (BP = 0048H) 


The V__NUMPAD service is the scancode translator for the numeric keypad. It verifies the Data 
Type is correct and maintains the state of the <Num lock> and <ScrLck> keys. 
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F_ISR (AH = OOH) 


Verify Data Type and update state variable. 


On Entry: AH = F__ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC_.NUMPAD = OFH) 
DL = Source vector address / 6 
BP = V__NUMPAD (0048H) 
On Exit! AH = Return status code 
BH = New keyboard state (only if state bit set in type) 
DH = New scancode type (T_KC__IBM__PC = OAH) 


Registers Altered: AX, BH, DH, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = V__NUMPAD (0048Hh) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


5.3.4.5 V__CCP (BP = O004EH) 


This translator service verifies the Data Type is T_KC__HP__CCP and then passes the ISR Event 
Record to its parent. By default this translator is mapped to the V__CCPCUR service, alternative 
mappings are presented in table 5.15. 
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Table 5.15 


V__CCP Driver Mapping Alternatives 


Driver Name Function 


V__OFF Discards the ISR event. 

V__RAW Returns the scancode untranslated. 

V__CCPNUM _ Translates the cursor control pad scancodes into cursor or numeric key 
pad scancodes, depending on the <Num Lock> and <Shift> states. 

V__CCPCUR _ Translates the cursor control pad scancodes into cursor scancodes, 

regardless of the <Num Lock> and <Shift> states. 


F_ISR (AH = OOH) 


This function verifies the Data Type and passes the event to Its parent. 


On Entry: AH = F_ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC__HP__CCP = ODH) 
DL = Source vector address / 6 
BP = V__CCP (004Eh) 
On Exit! AH = Return Status Code 
BL = Translated scancode 
BH = New keyboard state (only if state bit set in type) 
DH = New scancode type (T__KC__IBM__PC = OAH) 


Registers Altered: AX, BX, DH, BP, DS 


SF_INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Section 9 for a complete discussion of 
the protocol utilized in data space allocation (‘‘last used DS” passed in register BX). 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__INIT (OOH) 
BX = ‘‘Last used DS” in HP Data Area 
BP = V__CCP (004EhH) 
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On Exit: AH 
BX 


Return Status Code 
New “‘last used DS” in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06h) 
BP = V__CCP (O04EH) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


5.3.4.6 V__OFF Driver (BP = 0009CH) 


The V__OFF driver effectively turns off any translator mapped to it. It returns a Return Status 
Code of RS__DONE, this indicates to the driver which called that all processing is complete, and 
to return. Returning this status code effectively terminates processing of the scancode. 


F_ISR (AH = OOH) 


This function sets a return status of RS__ DONE and exits. 


On Entry: AH = F__ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (any type accepted) 
DL = Source vector address / 6 
BP = V__OFF (009CH) 
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On Exit: AH = RS_DONE 


Registers Altered: AX, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F_SYSTEM (02h) 


AL = SF__VERSION__DESC (06H) 
BP = V__OFF (009CH) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


5.3.4.7 V__RAW Driver (BP = 0090H) 


The V__RAW driver sets the data type to T_KC__IBM__PC (OAH) and returns, leaving the 
scancode untranslated. 


F_ISR (AH = OOH) 


This function sets a Data Type of T_KC__IBM__PC and a return status of RS__SUCCESSFUL. 


On Entry: AH = F__ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (any accepted) 
DL = Source vector address / 6 
BP = V__RAW (0090Hh) 
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On Exit: AH 
DH 


Return Status Code 
New scan code type (T_KC__IBM__PC = OAH) 


Registers Altered: AX, DH, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06h) 
BP = V__RAW (0090) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI_ = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


5.3.4.8 V__CCPNUM (BP = 0096H) 


The V__CCPNUM driver converts scancodes from the HP cursor control pad to their respective 
Numeric keypad equivalents. The resultant scancodes will be either numeric or cursor scancodes, 
depending on the state of the <Num Lock> and <Shift> keys. 


F_ISR (AH = OOH) 


This function translates the scancode, sets a new Data Type and exits. 


On Entry: AH = F__ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC__HP__CCP = ODH) 
DL = Source vector address / 6 
BP = V__CCPNUM (0096Hh) 
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On Exit: AH Return Status Code 


BH = New keyboard state (only if state bit set in type) 
BL = Translated scancode 
DH = New scancode type (T_KC__IBM__PC = OAH) 


Registers Altered: AX, BX, DH, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = V__CCPNUM (0096H) 
On Exit: AH = Return Status Code 
8X = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


5.3.4.9 V__CCPCUR (BP = 008AH) 


The V__CCPCUR service converts scancodes from the HP cursor control pad to their respective 
numpad or cursor contro! equivalents. The <Shift> key states in the keyboard state variable are 
adjusted to cancel the effect of the <Num lock> key and force the Numeric keypad to operate 
in cursor mode. Upon return from this translator chain, the logical keyboard driver generates the 
appropriate <Shift> scancodes to account for the change to the keyboard state variable. 


F_ISR (AH = OOH) 
This function translates the scancode to its Numeric keypad equivalent, changes the Data Type to 


T__KC__IBM__PC, and adjusts the keyboard state variable to force the Numeric keypad into 
cursor mode. 
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On Entry: AH = F__ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC__HP__CCP = ODH) 
DL = Source vector address / 6 
BP = V__CCPCUR (O08AH) 
On Exit: AH = Return Status Code 
BH = New keyboard state (only if state bit set in type) 
BL = Translated scancode 
DH = New scancode type (T_KC__IBM__PC = OAH) 


Registers Altered: AX, BX, DH, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_VERSION__DESC (06H) 


BP = V__CCPCUR (O08AH) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, Dl, ES, BP, DS 


5.3.4.10 V__SKEY2FKEY (BP = O00A8h) 


The V__SKEY2FKEY service translates HP Softkey scancodes into their industry standard function 
key equivalents. The driver makes no attempt to verify that the scancode passed is in the range 
for an HP Softkey. 

F_ISR (AH = OOH) 


This function translates the scancode, sets the Data Type to T__KC__IBM__PC and returns. 
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On Entry. AH = F_ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC__HP__SOFTKEY = OBH) 
DL = Source vector address / 6 
BP = V__SKEY2FKEY (OOA8H) 
On Exit: AH = Return Status Code 
BL = Translated scancode 
DH = New scancode type (T__KC__IBM__PC = OAH) 


Registers Altered: AX, BL, DH, BP, DS 


SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 


release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02h) 
AL = SF__VERSION__DESC (06H) 
BP = V__SKEY2FKEY (OOA8H) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


5.3.5 V__8041 Driver (BP = OOAEH) 


This driver provides an interface to the HP 8041 keyboard controller chip. It responds to 8041 
service requests and Input System logical interrupt requests (F__ISR’s) to output scancodes to the 
8041 chip. It also provides an application interface to 8041 timer services and switch settings. 
Table 5.16 contains a function code summary for this driver. 
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Table 5.16 


V__8041 Driver Function Code Summary 


Func. 
Value 


Vector 
Address 


OOAEH 
OOAEH OO 


04 
04/00-08 
O4/0A 
04/0C 
04/0E 
04/10 
04/12 
04/14 
04/16 
04/18 
O4/1A 


Function 


Equate 


V__ 8041 


F__ISR 


F__SYSTEM 
SF__INIT 
SF__START 
SF__VERSION__DESC 


F__IO__ CONTROL 


SF__CREAT__INTR 
SF__DELET__INTR 
SF__ENABL__INTR 
SF__DISBL__INTR 
SF__SET__RAMSW 
SF__CLR__RAMSW 
SF__SET__CRTSW 
SF__CLR__CRTSW 
SF__PASS__ THRU 


V__8041 Driver Function Definitions 


F_ISR (AH = OOH) 


Definition 


8041/keyboard interface. provides 
HP extensions to INT 16H 
Processes ISR event record 


System functions 

Initializes driver 

Driver Start-up 

Reports HP version number 


Driver Dependant Functions 
Reserved 

Create interval entry 
Delete interval entry 
Enable interval 

Disable interval 

Set RAM switch to one (1) 
Set RAM switch to zero (0) 
Set CRT switch to one (1) 
Set CRT switch to zero (0) 
Pass data byte to 8041 


This function processes a Keyboard ISR Event Record. It checks to see if the 8041 will accept 
another scancode. If not, the scancode is placed in a queue. If the 8041 can accept a scancode, 
it writes the scancode out. The scancode queue has room for 127 entries plus one overrun 


character. 
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On Entry: AH = F__ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
CX = Number of scancodes in buffer (string type only) 
DH = Scancode type 
DL = Source vector address / 6 
BP = V__8041 (OOAEH) 
ES:S| = Pointer to buffer (string type only) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Section 9 for a complete discussion of 
the protocol utilized in data space allocation (‘last used DS”’ passed in register BX). 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__INIT (OOH) 
BX = “Last used DS” in HP Data Area 
BP = V__8041 (OOAEH) 
On Exit: AH = Return Status Code 
BX = New “last used DS” in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF_START (AX = 0202H) 


This subfunction starts the 8041 driver. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__START (02H) 
BP = V__8041 (OOAEH) 

On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF_VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version 
number. The date code consists of two BCD coded bytes containing the year and week of 
release. The BL register contains the number of years since 1960 and the BH register contains the 
week of the year. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = V__8041 (OOAEH) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


SF_CREAT_INTR (AX = 040AH) 


The 8041 driver will call up to eight drivers at 1/60 second intervals. This subfunction creates an 
entry in the table of driver vectors which are called. Note that this subfunction only creates the 
entry; it does not enable the interval service. This is accomplished with the SF__ENABL__INTR 
subfunction. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__CREAT__INTR (OAH) 
BH = Vector number (vector address divided by six) of driver requesting service 
BP = V__8041 (OOAEH) 

On Exit: AH = Return Status Code 


RS__ FAIL indicates driver vector table full. 


Registers Altered: AX, BP, DS 


SF__DELET_INTR (AX = 040CH) 


This function removes the passed in vector number from the interval service table. 


On Entry: AH = F_lIO__CONTROL (04H) 
AL = SF__DELET__INTR (OCH) 
BH = Vector number (vector address divided by six) of driver to delete from table 
BP = V__8041 (OOAEH) 
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On Exit: AH = Return Status Code 
RS___FAIL indicates vector not in table. 


Registers Altered: AX, BP, DS 


SF_ENABL_INTR (AX = 040EH) 


This function enables interrupt service for a driver. The vector number passed is checked against 
the table. If an entry with that vector number is found, interval service is enabled. When the 
interval expires all enabled drivers in the list will be interrupted with a function code of 

F__ SYSTEM (02H) in AH and a subfunction code of SF__INTERVAL (14H) in AL. 


On Entry; AH = F_IO__CONTROL (04H) 
AL = SF__ENABL__INTR (OEH) 
BH = Vector number (vector address divided by six) of driver requesting service 
BP = V__8041 (OOAEH) 


On Exit: AH 


Return Status Code 
RS__FAIL indicates vector not in table. 


Registers Altered: AX, BP, DS 


SF__DISBL_INTR (AX = 0410H) 


This function disables interrupt service for a driver. The vector number passed is checked against 
the table. If an entry with that vector number is found, interval service is disabled. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__DISBL__INTR (10H) 
BH = Vector number (vector address divided by six) of driver to be disable 
BP = V__8041 (OOAEH) 

On Exit: AH = Return Status Code 


RS__ FAIL indicates vector not in table. 


Registers Altered: AX, BP, DS 


SF_SET_RAMSW (AX = 0412H) 


This function sets the industry standard extended RAM “‘switch”’ in the 8041 status register. This 
switch indicates that the second 256K RAM bank on the system board is enabled (default 
condition). 
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On Entry: AH = F_IO__CONTROL (04H) 
AL = SF_SET__RAMSW (12H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CLR_RAMSW (AX = 0414H) 

This function clears the industry standard extended RAM “‘switch” in the 8041 status register. 
When this switch is off it indicates that the second 256K RAM bank is disabled. Since this can 
never happen in the system this function should never be called. 


On Entry: AH = F_IO__CONTROL (04h) 
AL = SF__CLR__RAMSW (14H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_SET_CRTSW (AX = 0416H) 

This function sets the industry standard primary CRT “switch” in the 8041 status register. When 
the switch is set it indicates the primary display is attached to the Multimode graphics adapter 
(Default condition). 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF_SET__CRTSW (16H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CLR_CRTSW (AX = 0418H) 


This function clears the industry standard primary CRT “‘switch”’ in the 8041 status register. 
When this switch ts clear it indicates the primary display is attached to the monochrome display 
adapter. 
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On Entry: AH 
AL 


F__IO__CONTROL (04H) 
SF__CLR__CRTSW (18H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_PASS__THRU (AX = 041AH) 


This function outputs the byte in BL to the 8041 using the pass thru command to prevent the 
8041 from interpreting the data as a scancode or a command. 


On Entry: AH = F_IO__CONTROL (04H) 

AL = SF__PASS__ THRU (1AH) 

BL = data byte to pass thru the 8041 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


5.4 8041 Keyboard Controller 


5.4.1 Overview 


The primary function of the 8041 Keyboard controller is to emulate the industry standard 8042 
keyboard interface. (Directly accessing this hardware interface may affect program portability 
and is not recommended). The 8042 interface, in turn, emulates the keyboard interface of the 
IBM-PC. The 8041 keyboard controller acts as a command buffer from the STD-BIOS keyboard 
driver to the Input System while it acts as a loopback buffer for the Input System to the STD-BIOS 
keyboard driver. The 8041 is implemented in such a way as to maintain standard AT 
compatibility, while at the same time supporting all of the features of the Input System. 


The 8041 keyboard controller accepts commands from the STD-BIOS drivers that control the 
operation of the controller and the keyboard itself. These commands are detailed in the next 
subsections of this manual. Some of these commands are executed by the 8041 keyboard 
controller, but most are passed on the V__8041 interface driver for execution. 
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When the 8041 keyboard controller receives a command from the system that it cannot execute, 
it writes that command to its Keyboard Request Service Port ( SVC). This port resides in the 
system I/O port address space at O69H. Whenever a byte is written to this port, the 8041 also 
generates a hardware interrupt to notify the V__8041 interface driver of the request. 


The V__8041 driver reads the 8041 Keyboard Request Service Port, then performs a write to Port 
O6AH. Any value written to this port sends the 8041 an acknowledgement that the byte has 
been read, and clears the service request interrupt. 


The V__8041 driver then determines if it can execute the command. If it cannot, it calls its child 
driver, the V__HPHIL driver. The V__HPHIL driver will transmit the command to the keyboard. 
Examples commands executed by the keyboard are set typematic rate and delay values, set the 
state of keyboard LEDs, etc. 


The keyboard 8041 controller will accept and execute two sets of industry standard commands. 
One set is controller commands, the other set is keyboard commands, both sets are listed in 
table 5.17. Controller commands are executed by the 8041 controller or the V__8041 interface 
driver. Keyboard commands are executed by the keyboard directly. (In actuality, due to the 
keyboard implementation some of the keyboard commands are implemented by the V__8041 
interface driver.) 


Each of the command sets has its own protocol. The 8041 has two I/O ports, a command port 
(I/O address 64H) and a data port (I/O address 60H). Controller commands are written to the 
command port. If the command has parameters associated with it, the parameters are written to 
the data port. Keyboard commands are written to the data port. All data written to the data port 
is Interpreted as a keyboard command, unless the previous command written to the command 
port required parameters. 


5.4.2 8041 Controller and Keyboard Commands 


There are two sets of commands that are written to the 8041 chip. The first set controls the 
actions and state of the 8041 Keyboard controller chip. The second set is either passed on to the 
physical keyboard or emulated by the 8041 controller chip as if it were passed on to the physical 
keyboard to be executed. 8041 Controller Commands are written to output port 64H. If there is 
a data byte required by the command then it is written to (or read from) input port 60H. 
Keyboard Commands, however, are written to output port 60H. Again, if there is a data byte 
required it is written to output port 60H. 


The following code writes a one byte command to the 8041 controller to disable the keyboard 
interface. 
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‘ IBM cmdsstatus port 


IBM cmd/status port 
IBM data port 
Input buffer full mask 


‘ Disable interface 


; save working set of regs 


loop 64k times (if necessary) 
ints must be off for this loop 


get status and see if 8041 
input buffer if full 
loop if it is 


‘ load disable command and 


‘ 


- ship it out 


The following code writes a two byte command to the 8041 to turn on all the keyboard LED's at 


hp8041__cmd__port equ 64h 
hp8041__status__port equ 64h 
hp8041__data__port equ 60h 
hp8041__ibf__mask equ 02h 
hp8041__iface__dis equ OADh 
dis__8041 proc near 

push «x 

push ax 

xor CX, 

cli 
dis__8041__10: 

in al hp8041__status__port ; 

test al,hp8041__ibf__mask 

loopnz dis__8041__10 

mov al,hp8041__sface__dis 

out hp8041__cmd__port,al 

sti 

pop ax 

poop «x 

ret 
dis__8041 endp 
once. 
hp8041__cmd__port equ 64h 
hp8041__status__port equ 64h 
hp8041__data__port equ 60h 
hp8041__set__Jed equ Oedh 
hp8041__jbf__mask equ 02h 
led__data equ O7h 
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Hp8041 cmd/status port 
Hp8041 cmd/status port 
Hp8041 data port 


‘ Set keyboard leds command 


Input buffer full mask 
Led mask to send out 


set__8041 proc 
push 
push 
push 
xor 
mov 
mov 
cli 


set__8041__10: 
in 
test 
loopnz 


mov 
out 
cmp 
je 
mov 
xor 


jmp 


set__8041__ 20: 
sti 


pop 
pop 
pop 
ret 


set__8041 endp 


near 

CX 

bx 

ax 

CX,CX 

bh,led__data 
bl,hp8041__set__led 


al, hp8041__status__port ; 


al,hp8041__jbf__mask 
set__8041__10 


al, bl 
hp8041__data__port,al 
bh,al 

set__8041__20 

bl,bh 

CX, CX 

short set__8041__10 


ax 
bx 
Cx 


"save working set of regs 


' loop 64k times (if necessary) 
‘ load data for loop 

‘ load command 

‘ ints must be off for this loop 


get status and see if 8041 


* input buffer if full 
loop if it ts 


‘ load command and 
"ship it out 
; did we output both bytes 
; yes, skip out 
‘ set up for next iteration 


‘ loop 


CHANGE this to restore 


' int flag to previous state 
‘ Instead of on (if needed) 


Table 5.17 lists the 8041 Controller Commands. These commands are categorized as READ, 

SNGL, or DBL. READ commands cause the 8041 Controller to place the indicated data byte in it’s 
output buffer, input port 60H, to be read by the 80286. SNGL commands are commands written 
to output port 64H. DBL byte commands are written to output port 64H with the following data 
byte being written to output port 60H. 
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Table 5.17 


Controller Commands 


Command Type _ Description 


O20H READ Reads byte zero of the 8041's internal RAM. This byte is the last 
Keyboard Command Sent to the 8041. 


Q21H-O3FH READ Reads the byte specified by the lower five bits of the command 
in the 8041's internal RAM. E.g. 8041 Controller command 34H 
will report contents of the 14H byte of the 8041's RAM. 


Q60H-O/7FH DBL Writes the data byte to the address specified in the low five bits 
of the command. 


OQAAH SNGL Initiate Self-Test. This command instructs the 8041 to perform a 
self test. If no errors are detected, 55H Is returned in the Data 
Port. 


OABH SNGL Initiate Interface Test. This command instructs the 8041 to test 
the interface between itself and the keyboard. (Always returns 0 
= successful) 


READ Diagnostic Dump. The contents of the 8041 internal RAM 
registers (16 bytes), output port, input port, and status word are 
sent to the system. All diagnostic data is sent to the system in 
the same manner as scancodes. (Not supported) 


SNGL_ Disable Keyboard. This command disables the keyboard. Bit 4 of 
the current command byte will be set to ‘1° in the 8041. This Is 
equivalent to issuing a command byte with bit 4 set to ‘1°. Note 
that this command will have no effect if bit 3 of the command 
byte is set to ‘1". 

SNGL_ Enable Keyboard. This command re-enables the keyboard. Bit 
4 of the current command byte is cleared in the 8041. This is 
equivalent to issuing a command byte with bit 4 set to ‘0’. 


READ Read Input Port. The current value of the input port is returned. 
Bit 7 indicates the status of the front panel keylock. Bits O—3 
will always be reported as ‘1’. Bits 4—6 are undefined. 


READ Read Output Port. The current value of the output port Is 
returned. See table 5.20 for bit definitions. 
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Command Type _ Description 


OD1H DBL Write Output Port. The next byte written to the data port will be 
written to the 8041 output port. The bit definitions for this port 
are given in table 5.20. 


WARNING 


The System Reset bit should not be written low. To reset the system, use 
the Pulse Output Port command. 


SNGL_ Disable Address Bit 20. Disables the A20 address of the 
processor address bit. This is the normal state of this pin the in 
real addressing mode. 


SNGL_ Enable address Bit 20. Enables the A20 address of the processor 
address bit. This state is only used in protected mode. 


READ Read Test Inputs. This command will output the current state of 
the 8041 test inputs, TO and T1. The current state of TO is stored 
in bit O and T1 in bit 1. Both bits will be reported as ‘1’, unless 
the keyboard interface is inhibited. Bits 2 through 7 are 
undefined. 


OFOH-OFFH SNGL Pulse Output Port. Bits O—3 of the output port may be pulsed 
low for approximately 6 microseconds. Bits O through 3 the 
command contain a mask which is interpreted by the 8041 to 
determine which bits are pulsed. A bit is pulsed if its 
corresponding mask bit is ‘0’; if it is ‘1’ its current state is 
maintained. 


Note 


The System Reset bit is connected to bit 0. If the system needs to be 
reset, this command should be used (i.e., the bit should be pulsed, not 
brought low indefinitely.) 
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Table 5.18 indicates the format of the data byte written to the 8041 Controller subsequent to 
the 8041 Command 20H listed in table 5.17. 


Table 5.18 


Command Byte Format 


Data 
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Definition 


Reserved—must always be 0. 

Scancode conversion mode. 

The scancodes received from the keyboard are converted into 
PC/XT scancodes. 

Convert to AT scancodes. 

Acts as a NOP. 

Disable Keyboard. Data will not be sent or received by the 
keyboard. 

Disables the keyboard. 

Restore operation. 

Inhibit override. 

Prevents the keyboard from being disabled via bit 4. 

System Flag. The value of this bit is stored as the System Flag 
Bit. This bit may be read via port 60H. 

Reserved—must always be 0. 

Instructs the 8041 to Issue an OBF interrupt when data Is in 
the output buffer. 

Disables this feature. 


Table 5.19 indicates the format of the data byte written to the 8041 Controller subsequent to 
the 8041 Command ‘Write Output Port’ OD1H, or read from the 8041 Controller subsequent to 
the 8041 Command ‘Read Output Port’ ODOH. 

Table 5.19 


Output Port Bit Mask 


Data Definition 


Undefined 
Output Buffer Full Interrupt (OBF) 


HP SVC Interrupt 

HP-HIL Controller AutoPoll 
A20 Gate 

System Reset 


Table 5.20 lists the Keyboard Commands. These commands are categorized as SNGL or DBL. 
SNGL commands are commands written to output port 60H. DBL byte commands are written to 
output port 60H with the subsequent data byte, also, being written to output port 60H. The 
coding examples given for 8041 Controller commands is similar to the procedure for writing 
Keyboard Commands. The notable exception being the I/O address 60H is substituted for the I/O 
address 64H (defined with the equate, hp8041__cmd__porrt). 
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Table 5.20 


Keyboard Commands 


Command Type_ Description 


Set/Reset Mode Indicators. The keyboard has three status 
indicators; <Caps lock >, <Num lock>, and <Scrick>. This 
command is used to turn these indicators on and off. After the 
command is issued, the system must wait for an ACK from the 
keyboard (see below). When it is received, a second byte is 
issued to the keyboard. Bits O—2 represent the <ScrLck >, Num 
Lock, and <Caps lock>, respectively. Setting their respective 
bits to 1 turns the indicator on while a O turns it off. Bits 3—7 
should be set to 0. (See table 5.21) 


OEEH SNGL_ Echo. This is a diagnostic tool. When this command is issued, the 


keyboard returns an EEH. 


QEFH-QF2H SNGL No Operation (NOP). These codes are reserved for future use. 


DBL 
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The keyboard will acknowledge these codes, but no other action 
will be performed. 


Set Typematic Rate/Delay. This command sets the values for the 
typematic rate and delay. 


The typematic rate is the number of make scancodes per second 
sent in the tyoematic (repeat) mode. The delay is the amount of 
time a key must be held down until it enters the typematic 
mode. 


The rate and delay are passed in the next byte after the 
command. Bits 0 through 4 contain the rate and bits 5 and 6 
contain the delay. Bit 7 is unused. 


The HP8041 chip accepts STD AT typematic commands which 
are composed of two bits of delay (6,5) and five bits of rate 
(4-0). The two low order bits of the rate value are stripped off by 
the 8041 and the result translated into the HP-HIL typematic 
space. (See tables 5.25 and 5.26) 


Command Type _ Description 


OF4H SNGL_ Enable. This command enables keyboard action. The keyboard 
will issue an ‘ACK’ response, then begin sending scancodes as 
keys are pressed. 


SNGL_ Default Disable. This command sets the keyboard parameters to 
their power-on default state and disables the transmission of 
scancodes. The keyboard will send an ‘ACK’ response to this 
command. 


SNGL Set Default. This command sets the keyboard parameters to 
their power-on state and sends an ‘ACK’ response. the keyboard 
will continue to transmit scancodes after receipt of this 


command. 


OF7H-OFDH SNGL No Operation (NOP). These codes are reserved for future use. 
The keyboard will acknowledge these codes, but no other action 
will be performed. 


SNGL_ Resend. This command may be sent to the keyboard whenever 
an error Is detected by the system. This command must be sent 
before the next scancode Is to be transmitted. If the last code 
sent by the keyboard was a Resend command, the keyboard will 
send the prior code. 


SNGL This command instructs the keyboard to perform its Power-On 
Reset function. This step takes at least 300 milliseconds, during 
which the keyboard is disabled. 
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Table 5.21 indicates the format of the data byte written to the output port 60H subsequent to 
the Keyboard Command ‘Set Mode Indicators’ OEDH. 


Table 5.21 


Set Mode Indicators Data Byte Format 


Data Definition 


Reserved, should be set to zero 
Caps Lock Mode Indicator 
Turns off Caps Lock indicator 
Turns on Caps Lock Indicator 
Num Lock Mode Indicator 


Turn off Num Lock indicator 
Turn on Num Lock indicator 
Scroll Lock Mode Indicator 

Turn off Scroll Lock indicator 
Turn on Scroll Lock indicator 


5.4.3 8041 to STD-BIOS Scancodes and Commands 


The keyboard (emulated by the 8041 ) sends scancodes and commands to STD-BIOS driver 
system . The scancodes/commands are read from the 8041 Data port (Input Port 60H). Table 
5.22 lists the keyboard codes returned by the keyboard. As with the controller commands, some 
of these codes are initiated by 8041 interface driver and not the physical keyboard on the HP-HIL 
link. 
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Table 5.22 
8041 to STD-BIOS Scancodes and Commands 


Code/ 
Command Description 


OOH OVERRUN. This code indicates that the 16 character keyboard buffer has 
overflowed. 

O1H-77H Keyboard Scancodes. These represent the keys on the 81H-OF7H keyboard. 
The scancodes are listed in table 5.4. 

OQAAH The 8041 Controller will report this byte when it completes the 8041 
Controller's Self Test. This test is executed at Power on and after receiving 
the Keyboard Command OFFH, Reset. Note: any other byte reported at 
these times indicates failure. 

ECHO: this code is sent in response to the keyboard ECHO__COMMAND 
command, OEEH. 

Break Prefix code. This code is sent to indicate a key break. This code is 
followed by the scancode of the key being released. This code will be sent 
only in the AT scancode set mode. 

ACK. this code is sent to acknowledge receipt of a command (except Echo 
and Resend). 

Diagnostic Failure. This code is sent if a keyboard failure is detected. 
Resend. This code is sent if the keyboard receives an invalid command or 
detects an error in the transmission. 


5.4.4 8041 to Logical Keyboard Driver Communication 


The 8041 acts as an intelligent bi-directional buffer between the logical keyboard driver (Input 
System) and the INT O9H driver and system software. The INT O9H driver and system software 
communicate with the 8041 via the command and data ports (I/O addresses 64H and 60H 
respectively). The 8041 has two additional ports which are used to communicate with the logical 
keyboard driver. 


The output port 068H is used by the logical keyboard driver to transfer data and commands to 
the 8041 without overlapping with the industry standard keyboard commands. Data such as 
keyboard scancodes and commands are transmitted in this manner. The HP specific commands 
are listed in table 5.23. 
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Table 5.23 


HP-Specific Commands to the HP-8041 


Keycode 
Value 


OOH-O54H 


80H-OD4H 


Keycode/Command Definition 


Industry standard make scancodes. The data byte will be put into an 
8041 internal scancode buffer, it will loopback the scancode buffer when 
the 8041's output port is empty. 

Industry standard break scancodes. The data byte will be put into an 
8041 internal scancode buffer, it will loopback the scancode buffer when 
the 8041's output port is empty. 


OSSH-O77H HP enhanced keyboard make scancodes. The data byte will be put into 


an 8041 internal scancode buffer, it will loopback the scancode buffer 
when the 8041's output port is empty. 


ODSH-OF?/H HP enhanced keyboard break scancodes. The data byte will be put into 


O78H 
O79H 
O7AH 


O7BH 
O7CH 
O7DH 
O7EH 


O7FH 
OF8H 


OF9OH 


an 8041 internal scancode buffer, it will loopback the scancode buffer 
when the 8041's output port is empty. 

Reserved 

Reserved 

Pass through the next data byte written to output port O68H. The data 
byte will be put into an 8041 internal scancode buffer, it will loopback 
the scancode buffer when the 8041's output port is empty. 

Set the RAM Switch to ‘0’. 

Set the RAM Switch to ‘1° (Default). 

CRT__OFF: Set the CRT Switch to ‘0’. Indicates the primary display Is a 
monochrome-printer adapter. 

CRT__ON: Set the CRT Switch set to ‘1°. Indicates the primary display 
adapter is the Color/Graphics or Multimode adapter (Default). 

HP Reserved 

ENABLE__AUTOPOLL: Enables the SVC Port request AUTOPOLL__EVENT 
to be sent to the system. This command allows the 80286 to take over 
the HP-HIL polling function. The AUTOPOLL__EVENT SVC request is made 
approximately 60 times a second whenever this command is in effect. 
DISABLE__AUTOPOLL: Disable the AUTOPOLL__EVENT SVC request. 


OFAH-OFEH Reserved 
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KEYBOARD__OVERRUN: This is passed through as any normal keyboard 
scancode. This command is sent from the 8041 driver to the logical 
keyboard to the 8041 chip to indicate the logical keyboard's data buffer 
was overrun. 


To verify that the command has been read, the software can read the IBF bit in the status 
register of the controller. 


The 8041 transfers data and commands to the logical keyboard driver through the SVC (Service) 
port (I/O address 69H). When data is present on this port, the 8041 issues an interrupt alerting 
the 8041 interface driver of the data. The 8041 interface driver reads the data from the SVC 
port, then writes any value to the Acknowledge port (I/O address 6AH) which sends an 


acknowledge signal to the 8041 and clears the interrupt. Table 5.24 defines the SVC Register 
request functions. 
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Table 5.24 
SVC Port Request 


KBD HP 
Command SVC Request 
Hex Binary Function 


OFFH yroO 0000 HP Reserved 
OO1H yroO 0001 RESET__KBD: resets the keyboard to power-on state, clear 

scancode buffer, flash LED’s on then off, and set default 
typematic rate and delay. At completion the keyboard is 
enabled. 

yroO0 0010 Reserved 

yroO0 0011 AUTOPOLL__EVENT: a programmatic autopoll interval 
occurred 

yroO 0100 Reserved 

yroO 0101 Reserved 

yrOoO 0110 SELECT__PC__SET: select the PC compatible scancode set. 

yroO 0111 SELECT__AT__SET: select the AT compatible scancode set. 

yro0 1000 BUFFER__ROOM: The internal 8041 scancode buffer has 
available room for scancodes. 

yrO0O~=+1001 DEFAULT__KBD: set default keyboard values: clear 
scancode buffer, and set default tyoematic rate and 
typematic delay (keyboard LED are not affected). 

yroO + 1010 DISABLE__KBD: disables the keyboard: set default values 
Same as DEFAULT__KBD command, except the keyboard 
is left in the disabled state. 

yroO +1011 ENABLE__KBD: enables the keyboard, clear scancode 
buffer, and leave the keyboard in the enabled state. 

yrid dttt SET__TYPEMATIC: set typematic repeat rate and delay 
before repeat. The lower three bits, ‘ttt’, is an index which 
specifies the repeat rate and the bits four and five, ‘dd’ 
specifies the delay before the first key is repeated (See 
tables 5.25 and 5.26). 

mmmm SET_MODE__INDICATORS: turns the keyboard LED's on 
or off, where ‘mmmmi is the led mask A one, ‘1’, will 
turn on and LED while a ‘0° will turn the LED off. 

When bit seven ‘y’ is one ‘1’ then logical keyboard Is inhibited 
from writing scancodes into the 8041. When ‘y’ is zero ‘0° then 
the logical keyboard can write scancodes into the 8041. 

Bit six is reserved. 
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Table 5.25 defines the HP-HIL command and approximate delay before repeat value used for 
each of the HP8041 delay possibilities. This table assumes an HP-HIL poll rate of 60 cycles per 
second. 


Table 5.25 


Typematic Delay Coversion 


HP8041 Cursor Pad Non-cursor Pad 
Delay HP-HIL Delay HP-HIL Delay 
‘dd’ Command Period Command Period 


O4H 0.283 OQ2H 
O7H 0.483 O4H 
OCH 0.817 O6H 
OEH 0.950 OQ7H 


Table 5.26 defines the HP-HIL command and approximate typematic rate value used for each of 


the HP8041 typematic rate possibilities. This table assumes an HP-HIL poll rate of 60 cycles per 
second. 


Table 5.26 


Typematic Repeat Rate Conversion 


HP8041 Cursor Pad Non-cursor pad 


Typematic HP-HIL Typematic HP-HIL Typematic 
Rate‘ttt' Command Rate Command Rate 


30.00/sec 30.00/sec 
20.00/sec 20.00/sec 
15.00/sec 15.00/sec 


10.00/sec 10.00/sec 
7.50/sec 7.50/sec 
6.00/sec 6.00/sec 
5.00/sec 5.00/sec 
4.00/sec 4.00/sec 


Keyboard 195 


196 Keyboard 


SECTION 6 


TABLE OF CONTENTS 
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6.3 V_.LHPMOUSE Driver (BP = O00CCH) 


HP Mouse Driver Function Definitions 
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6.2 Mouse Driver (INT 33H) 


Mouse Driver Function Definitions 
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SECTION 6. MOUSE 


The mouse driver discussed in this section provides the HP Mouse with the Microsoft Mouse (tm) 
compatible (INT 33H) application interface. There are two additional mouse drivers supplied with 
the system, the pointer driver (simple mouse) discussed in Section 4 and the cursor key emulator 
discussed in Appendix G. Some of the terminology in this section is defined in Section 4. 


6.1 Overview 


The industry standard mouse Is accessed through software interrupt 33H. The INT 33H driver 
receives data from the logical mouse driver (V__LHPMOUSE). If the HP-HIL mouse is present at 
boot time, V__LHPMOUSE initializes INT 33H to the industry standard interface driver. The 
industry standard interface supports both a polled mode and interrupt mode of data retrieval. 
The following data flow outlines the process of mouse data input. 


1. The mouse is moved. This causes the physical device to generate input data and interrupt 
the hardware interface level drivers. 


2. The hardware interface level processes the interrupt and passes the data (ISR Event Record) 
to the logical mouse driver (V__LHPMOUSE). 


3. V__LHPMOUSE scales and clips the input data and stores it for the industry standard 
interface to use. 


4. |f using polled mode the application must inquire if the data is available. If using interrupt 
mode the application will be interrupted to notify it that the data is available (via INT 33H). 


Steps 1 and 2 above have been discussed in Section 4. Step 3 involves processing the ISR Event 
Record into the data format used by the INT 33H driver. At this point, if the user has defined and 
installed an interrupt handler with function F33__SET__USR (OCH), that routine will be called. INT 
33H also defines functions to allow the application to poll for mouse data. 


The screen modes supported by the mouse driver are shown in table 6.1 The (0,0) origin for the 


display is in the upper left hand corner of the display. All data reported is in the ranges: 0 to 199 
for y-axis and 0 to 639 for the x-axis. 
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Table 6.1 


Video Display Modes Supported 


Mode X range Yrange Comments 


80x25 0..632 X-axis data is in multiples of 8, y-axis data is in 
multiples of 8 


40x25 0..624 X-axis data is in multiples of 16, y-axis data Is In 
multiples of 8 

320x200 0..638 X-axis data is in multiples of 2 

640X200 0..639 Reports full range for both axes 


6.2 Mouse Driver (INT 33H) 


The following section discusses the INT 33H driver. Table 6.2 contains a function summary of the 
INT 33H driver. 
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Table 6.2 


Mouse Driver Function Code Summary 


INT 
Hex 


33H 


Function 
Equate 


INT__HPMOUSE 
F33__ INSTALL 

F33__ ENABLE 

F33__ DISABLE 

F33__ REPORT__DATA 


F33__PUT__CURSOR 
F33__REPORT__PRESS 
F33__REPORT__RELEASE 
F33__SET__HORIZ 
F33_ SET__VERT 


F33__GRAPH__CURSOR 
F33__TEXT__CURSOR 
F33__ MOTION 
F33__SET__USR 

F33_ ENABLE__LIGHT 


F33__DISABLE__ LIGHT 
F33__ RATIO 
F33__COND__OFF 
F33__XTEND__GCSR 
F33__ SPEED 


F33__ INQUIRE 


Function 
Value 


O6H 
O7H 
O8H 


OOH 
OAH 
OBH 
OCH 
ODH 


OEH 
OFH 
10H 
12H 
13H 


6FOOH 


Mouse Driver Function Definitions 


F33__INSTALL (AX = 0000H) 


Definition 


Mouse installed flag 

Puts cursor on screen 

Turn off cursor 

Get position/button information 


Position the cursor 

Report button press status 
Report button release status 
Sets min/max horizontal values 
Sets min/max vertical values 


Define graphics cursor 
Define text cursor 
Report motion counters 
Define user subroutine 
Unsupported 


Unsupported 

Set pixel movement ratio 

Define conditional off area 
Extended sprite graphics entry point 
Sets mouse movement doubling 


EX-BIOS mouse driver present 


This function is called by the application to determine if the mouse is connected to the HP-HIL 
link. If the mouse is connected, the physical GID driver for the mouse is mapped to the 


V__LHPMOUSE, and the internal data area is set to its default values. If the mouse is connected a 


— 1 is returned in AX, otherwise a zero is returned. 
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The default values set are: 
cursor position 
internal cursor flag 
graphic cursor shape/hot spot 
text cursor 
user-defined call mask 
light pen emulation mode 
X axis mickies to pixel ratio 
Y axis mickies to pixel ratio 
min/max cursor position X axis 


min/max cursor position Y axis 


On Entry: AX = F33__INSTALL (O000H) 
On Exit: AX = mouse status 
BX = number of buttons 


Registers Altered: AX, BX 


screen center 
cursor off 
arrowl(— 1, — 1) 
inverting box 

all zeros 
disabled 

8 to 8 

16 to 8 

0/639 


0/199 


The following example shows how the mouse driver is called. 


MOV AX, F33__INSTALL ; load function code 
INT  INT__HPMOUSE ; call the driver (33H) 


F33_ ENABLE (AX = 0001H) 


This function increments the internal cursor flag. If the flag is 0, the cursor is displayed on the 
screen. When the cursor is on the screen, moving the mouse will cause the mouse cursor to 


also move. 


On Entry: AX = F33__ENABLE (0001H) 
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On Exit: None 


Registers Altered: None 


F33__ DISABLE (AX = 0002H) 


This function decrements the cursor flag count. If the flag has a non-zero value, the cursor is 
removed from the display. 


On Entry: AX = F33__DISABLE (0002H) 
On Exit: © None 


Registers Altered: None 


F33__REPORT__DATA (AX = 0003H) 


This function reads the position (x,y) of the mouse and the state of the mouse buttons. The 
button status is described in table 6.3. 


Table 6.3 
Mouse Button Status Table 


Data Button Status Definition 


Reserved 
Right button up 


Right button down 
Left button up 
Left button down 


On Entry: AX = F33__REPORT__DATA (0003H) 
On Exit: BX = button status 

CX = x position 

DX = y position 


Registers Altered: BX, CX, DX 
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F33__PUT_CURSOR (AX = 0004H) 


This function changes the cursor position on the screen. If the new cursor position is within the 
currently defined limits, the cursor is moved to the new position. If the new position is outside of 
the limits, the cursor is removed from the screen. The new position of the cursor must be set to 
values supported by the current screen mode. 


On Entry: AX = F33__PUT__CURSOR (0004H) 
CX = new x cursor position 
DX = new y cursor position 


On Exit: None 


Registers Altered: None 


F33__REPORT__PRESS (AX = 0005H) 


This function reports the button press information. The press count button status and cursor 
position of the last press is returned. The button status is defined in table 6.3. Notice that the 
position represents the position of the cursor at the last press, and may not reflect the current 
cursor position. The press count is cleared after the call. 


On Entry: AX = F33__REPORT__PRESS (0005H) 
BX = button number 
On Exit: AX = button status 
BX = press count 
CX = xX position at last press 
DX = y position at last press 


Registers Altered: AX, BX, CX, DX 


F33__REPORT__RELEASE (AX = 0006H) 


This function reports the button release information. The release count button status and cursor 
position of the last release is returned. The button status is defined in table 6.3. Notice that the 
position represents the position of the cursor at the last press, and may not reflect the current 
cursor position. The release count is cleared after the call. 


On Entry: AX 
BX 


F33__ REPORT__RELEASE (O006H) 
button number 
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On Exit: AX = button status 
BX = release count 
CX = x position at last release 
DX = y position at last release 


Registers Altered: AX, BX, CX, DX 


F33__SET_HORIZ (AX = 0007H) 


This function defines the minimum and maximum horizontal positions reported. If the cursor is 
outside the new boundary, the cursor is moved just inside the boundary. If the minimum 
parameter is greater than the maximum parameter, the parameters are swapped. 


On Entry: AX = F33__SET__HORIZ (0007H) 
CX = minimum position 
DX = maximum position 


On Exit: None 


Registers Altered: None 


F33_SET_VERT (AX = 0008H) 


This function defines the minimum and maximum vertical positions that are reported. If the 
cursor Is Outside the new boundary, the cursor is moved just inside the boundary. If the 
minimum parameter is greater than the maximum parameter, the parameters are swapped. 


On Entry: AX = F33__SET__VERT (O008H) 
CX = minimum position 
DX = maximum position 


On Exit: None 


Registers Altered: None 


F33__GRAPH__CURSOR (AX = 0009H) 


This function defines the graphics cursor or sprite. This allows the programmer to define what 
the 16 pixel by 16 pixel sprite is to look like. The programmer defines both the AND mask and 
the XOR mask. The masks must be defined in contiguous memory. You must also pass in the 
sprite hot spot. The hot spot must be in the range of —16 to 16. The term’’hot spot” refers to 
the point, inside or outside of the sprite, which positions the sprite. The hot spot origin is defined 
by the upper left hand corner of the sprite. 
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On Entry: AX = F33__GRAPH__CURSOR (0009H) 


BX = horizontal hot spot 
CX = vertical hot spot 
ES:DX = pointer to AND and XOR masks 
On Exit: | None 


Registers Altered: None 


The following example shows how to define the graphics cursor. The hot spot for the example 


cursor given is at (5,1). 


SPRITE DW OFOFFH , 171171001711171117177 “*” marks the 
DW OFOFFH , 11110*0011111111 Hot Spot 
DW OEO7FH , 1110000001111111 
DW OEO7FH , 1110000001111111 
DW OCO3FH , 1100000000111111 
DW OCO3FH ; 1100000000111111 
DW 0801FH , 1000000000011111 
DW 0801FH ;, 1000000000011111 
DW OOOOFH ; 0000000000001111 
DW OOOOFH ; 0000000000001111 
DW OFOFFH , 11110000111111171 
DW OFOFFH , 111100001117111171 
DW OFOFFH ; 117111000011711111171 
DW OFOFFH , 1111000011111111 
DW OFOFFH , 11110000111111171 
DW OFOFFH , 11110000111171117 

; Define the XOR mask 
DW OOOOOH , OOOCOO00C00000000 3 *’*’’ marks the 
DW OO600H , 00000* 1000000000 Hot Spot 
DW OOFOOH ; 0000111100000000 
DW OOFOOH , 0000111100000000 
DW O1F80H , 0001111110000000 
DW O1F80H , 0001111110000000 
DW O3FCOH , 0011111111000000 
DW O3FCOH ; 0011111111000000 
DW O7FEOH , 0111111111100000 
DW OO600H ; 000001 1000000000 
DW OO600H , 000001 1000000000 
DW OO600H , 000001 1000000000 
DW OO600H ; 000001 1000000000 
DW OO600H , 000001 1000000000 
DW OO600H , 000001 1000000000 
DW OOOOOH , OOOOOOOOOCO000000 
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MOV AX, F33__GRAPH__CURSOR_; load the function code 


MOV Bx,5 ; hot spot at (5, 1) 

MOV Cx, 1 

PUSH DS 

POP ES , set up the es register 
LEA DX, SPRITE ; load offset of sprite 
INT INT__HPMOUSE ; call mouse driver (33H) 


F33__TEXT__CURSOR (AX = 000AH) 


This function defines either a software text cursor, or what the hardware text cursor looks like. 
The parameter in BX selects the cursor type. When BX equals one, the hardware cursor is 
defined. When BX equals 0, the software cursor is selected. If the hardware cursor is selected, 
then the parameters in CX and DX define the first and last scan line of the hardware cursor. If 
the software cursor is selected, then CX defines the AND mask for the character and attribute 
bytes. DX defines the new character and attribute bytes. 


On Entry: AX 
BX 


F33__TEXT__CURSOR (OQO0AH) 
Cursor Type 


Data Definition 
@) Software cursor 
1 Hardware cursor 


For software cursor: 
CX = attribute/character AND mask 
DX = attribute/character XOR mask 
For hardware cursor: 
CX = first scan line 
DX = last scan line 
On Exit: None 


Registers Altered: None 


F33_ MOTION (AX = OOOBH) 


This function reads the mouse motion counters. Both the X and Y motions are reported. A 
positive X motion indicates a movement to the right. A positive Y motion represents a movement 
to the bottom of the screen. The motion counters are cleared after the function call. 
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On Entry: AX = F33_ MOTION (OOOBH) 


On Exit: CX = X axis count 
DX = Y axis count 


Registers Altered: CX, DX ~ 


F33_ SET_USR (AX = 000CH) 
This function defines the user-defined subroutine to be called at interrupt service time. The 


function allows the programmer to select which events the routine is to handle. The condition 
mask is defined in table 6.4. A call to F33__INSTALL disables this feature. 


Table 6.4 


User-defined Routine Event Definition 


Value Definition of Event 


Reserved 
Right button released 


Right button pressed 
Left button released 
Left button pressed 


Any mouse movement 


When the subroutine is invoked, the following information is in the registers: 


Register Data 
AX Event mask which describes the event. The table 6.4 defines the events. A set bit 
indicates the event. 

BX button state (see table 6.3) 
CX X position 
DX Y position 
On Entry: AX = F33__SET__USR (O00Ch) -~ 

CX = condition mask 

ES:DX = address of the user defined subroutine 
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On Exit: © None 


Registers Altered: None 


F33__ENABLE_ LIGHT (AX = O000DH) 


This function is not currently supported. 


F33__DISABLE_ LIGHT (AX = OOOEH) 


This function is not currently supported. 


F33__RATIO (AX = OOOFH) 


This function sets the sensitivity of the mouse movement. Logical mouse movement, in pixels, 
corresponds to an amount of actual physical device movement, In mickies. This ratio of logical to 
physical movement specifies the number of pixels to move for some number of mickies. This 
function allows you to change the ratio to any value in the range 1 to 32767. 


On Entry: AX = F33__RATIO (OQOOFH) 
CX = mickies to pixels ratio for X axis 
DX = mickies to pixels ratio for Y axis 


On Exit: None 


Registers Altered: None 


F33_ COND__OFF (AX = 0010H) 


This function defines an area on the screen which is considered a fast update area. If the cursor 
is within this area, then the cursor is removed from the screen, and the area can be quickly 
updated. If the cursor is not within the specified area, then it is not removed from the screen. 
After a call to this function is made, a call to F33__ENABLE must always be made to turn the 
cursor back on. If the upper and lower coordinates are entered in reverse order, the values are 
swapped. 


On Entry: AX = F33__COND__OFF (0010H) 
CX = upper x screen coordinate (closest to (0,0)) 
DX = upper y screen coordinate 
S| = lower x screen coordinate (farthest from (0,0)) 
D| = lower y screen coordinate 
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On Exit: None 


Registers Altered: None 


F33_XTEND_GCSR (AX = 0012H) 


This function defines the graphics cursor sprite. The new sprite can be larger or smaller than the 
previous sprite. The maximum size of the graphics cursor sprite is 144. This number is the 
product of number of scan lines (CH) times the number of bytes (BH*2) the sprite spans. This 
function allows you to define a sprite similar to F_GRAPH__CURSOR. 


On Entry: AX = F33__XTEND__GCSR (001 2H) 
BH = number of words the sprite spans in X axis 
BL = hot spot x 
CL = hot spot y 
CH = # of scanlines in sprite 
ES:DX = point to the new sprite masks 
On Exit: AX = —1 


Registers Altered: AX 


F33_ SPEED (AX = 0013H) 


This function sets the minimum distance doubling parameter. This allows you to set the 
sensitivity such that the physical mouse need not travel as far to go across the entire screen. If 
the mouse moves the number of mickies defined by this function, then the movement for the 
mouse is doubled. 


F33__ SPEED (0013H) 
minimum to double 


On Entry: AX 
DX 


On Exit: None 


Registers Altered: None 


F33__ INQUIRE (AX = 6FOOH) 
This function can be used to determine if the mouse driver being used was written by HP. 


On Entry: AX = F33__INQUIRE 
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On Exit: BX = ‘HP (4850H) 


Registers Altered: BX 


6.3 V__LHPMOUSE Driver (BP = OOCCH) 


This section describes the EX-BIOS calls for compatible mouse driver. These functions constitute 
the interface between this driver and the Input System. Table 6.5 contains a function summary of 
V__LHPMOUSE. 


Table 6.5 
V__LHPMOUSE Driver Function Code Summary 


Vector Func. Function 
Address Value Equate Definition 


OOCCH OO F__ISR Logical Interrupt 


OOCCH 02 F_ SYSTEM System Intrinsics 
OOCCH 02/00 SF__INIT Initializes driver 


OOCCH 02/02 SF__START Starts driver 


04 F_ IO. CONTROL I/O control driver functions 

04/00 SF__MOUSE__COM BIOS mouse install function 

04/02 SF__.MOUSE__ OVERRIDE Install INT 33H even though mouse 
is not connected 


HP Mouse Driver Function Definitions 


F_ISR (AH = OOH) 


This function receives an ISR Event Record from physical GID drivers. This function translates the 
physical event into the logical coordinate system used by the INT 33H mouse driver. This function 
is responsible for updating the INT 33H data area. This includes calculating the mickies to pixel 
ratio, updating the motion counters, and displaying the mouse cursor. 
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On Entry: AH = F__ISR (OOH) 
DH = Data Type (see Table 4.12) 
DL = Physical device driver's vector index. 
ES:0 = Pointer to Physical Describe Record. 
BP = V__LHPMOUSE (00CCH) 


For Button Event: 


BX = Button information. 


Bit Value Definition 
OFH-O8H — Reserved 
07H 1 Button up 

0 Button down 


O6H-OOH Button number (0-7) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_INIT (AX = 0200H) 


This subfunction Is called to initialize the driver. Refer to Section 9 for a complete discussion of 
the protocol used in data space allocation (“‘last used DS”’ passed in register BX). 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__INIT (OOH) 
BX = “Last used DS” in HP Data Area 
BP = V__LHPMOUSE (OOCCH) 
On Exit: AH = Return Status Code 
BX = New’''last used DS” in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF_START (AX = 0202H) 


This subfunction starts the driver. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__START (02H) 
BP = V__LHPMOUSE (OOCCH) 
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On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_MOUSE_ COM (AX = 0400H) 


This function is used by the BIOS to initialize INT 33H after MS-DOS has been initialized. This 
function checks for the presence of a mouse. If the mouse is found then INT 33H, is set up to 
point to the mouse driver. If no mouse is found, then INT 33H is not initialized. 


On Entry: AH = F_IO__CONTROL (04h) 
AL = SF_.MOUSE__COM (00H) 
BP = V__LHPMOUSE (OOCCH) 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_MOUSE OVERRIDE (AX = 0402H) 


This function is used to set up INT 33H even if there is no mouse present. This function is 
provided in case an application wishes to map any GID device to the V__LHPMOUSE driver. Since 
no mouse Is connected to the HP-HIL link, the mouse driver will not be installed, thus this 
function enables you to override what is currently at INT 33H. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF_.MOUSE__OVERRIDE (02H) 
BP = V__LHPMOUSE (OOCCH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SECTION 7. SERIAL AND PARALLEL I/O 


This section covers the ROM BIOS support for the system serial and parallel I/O ports. The ROM 
BIOS supports up to four parallel ports and up to four serial ports. However, DOS only provides 
logical devices for three parallel printer ports and two serial ports. 


7.1 Overview 


The ROM BIOS provides two STD-BIOS drivers that control the serial (INT 14H) and parallel (INT 
17H) ports. The functions in these drivers provide a means of setting communication parameters 
and transmitting data. These drivers have expanded functionality that provide the programmer 
with the additional ability to set higher baud rates and to transfer strings of data. In addition to 
these drivers, the print screen driver (INT 05H) will be discussed in this section. 


7.1.1. Serial And Parallel Port Addresses 


The STD-BIOS data area contains two tables used by the serial and parallel port drivers. The Serial 
Base Port Address Table contains the base port addresses for the serial ports. The Parallel Base 
Port Address Table contains the base addresses of the parallel ports. The ROM BIOS checks 
during SYSGEN for the presence of serial and parallel adapter cards at the addresses listed in 
table 7.1. When a valid port is found, the base address of that port is placed in the next 
available entry of the appropriate table. Application programs may add additional parallel ports 
or serial ports to the port tables. An application program can also replace the values in the table 
with new ones to support non-standard port addresses. Each table contains space for four 
entries. 
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Table 7.1 


Serial and Parallel Port Addresses 


I/O Address IRQ 


Port addresses are added to the base port address tables in the sequence listed in table 7.1. If the 
system has only two parallel I/O ports at addresses 378H and 278H then 378H becomes the first 
entry in the table (Port 0) and 278H becomes the second (Port 1). The potential parallel port at 
3BCH would not be Port 0 as it is not present in the system. 


The functions supported by the serial and parallel port drivers rely on the values contained in the 
serial base port address table and the parallel base port address table. The ports are referenced 
by indexes into the tables (port numbers 0-3). 


7.1.2. Print Screen Driver 


The print screen driver provides a simple method for application programs and system software 
to print a copy of the screen contents to the system printer (port 0). The ROM BIOS print screen 
driver will only print the screen if the display adapter is in one of the alphanumeric modes. 
Support for printing the screen when in graphics modes |s provided by the DOS command 
GRAPHICS. 
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7.1.3 Polled and Interrupt Driven Operations 


Both the serial and parallel ports on the system may be operated in either a polled or interrupt 
mode. The drivers in the ROM BIOS only support polled operation. Four system interrupts, OBH, 
OCH, 72H and 73H, are reserved for system serial ports. Two system interrupts, ODH and OFH, 
are reserved for system printers. Application programs and system software may use these 
interrupts to operate the ports in an interrupt mode. 


7.2 Data Structures 


The data structures for the serial port, parallel port, and print screen drivers are located in the 
STD-BIOS data area. The data structures for each of the drivers are discussed separately. 


7.2.1. Serial Port Driver Data Structures 


The serial port driver uses two data structures in the STD-BIOS data area; a base port address 
table, and a timeout counter table. The addresses of these data structures are listed in table 7.2. 
The equipment word in the STD-BIOS data area (40:10H), contains the number of serial and 
parallel ports configured in the system. The equipment byte can be read by the INT 11H 
equipment determination function. 


Table 7.2 
Serial Port Data Structures 


Port Port Address Timeout Timeout 
Number Table Entry Table Entry (Default) 


40:00H 40:7CH (01H) 


40:02H 40:7DH (01H) 
40:04H 40:7EH (01H) 
40:06H 40:7FH (01H) 
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Each serial port is comprised of eight 80286 I/O addresses. The base address of each block of I/O 
addresses is stored in the base port address table. For more information see Vectra Technical 
Reference Manual Volume |. The table consists of 4 words (8 bytes), one for each of the four 
possible serial ports. A zero value for any of the words is interpreted by the driver to mean the 
port is not present. 
~ 
The second data structure used by the serial port driver is the timeout table. This data structure ~ 
consists of 4 bytes, one for each of the serial ports. Whenever the driver attempts to read or 
write data or parameters it reads the status port on the serial port. To prevent an error condition 
on the serial port from hanging up the system it uses a timeout loop. If a valid status byte cannot 
be read within the time allotted, the driver will return with a timeout error status code. The 
length of the timeout is determined by the entries in the timeout table. Each of the four serial 
ports can be given a different timeout value by an application program. 


7.2.2 Parallel Port Driver Data Structures 


The parallel port driver uses two data structures that are similar to those used by the serial port 
driver. The addresses of the parallel base port address and timeout tables are listed in table 7.3. 


Table 7.3 
Parallel Port Data Structures 


Port Port Address Timeout Timeout 
Number Table Entry Table Entry (Default) 


40:08H 40:78H (14H) 


40:0AH 40:79H 
40:0CH 40:7AH 
40:0EH 40:/7BH 


Each of the parallel ports occupy four I/O addresses. The base or first address of each is 
contained in the base address table. A zero value for any of the words is interpreted by the driver -~ 
to mean the requested parallel port adapter is not present. 
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The parallel printer port driver checks the status of the port before it outputs a character to 
determine if the printer is busy. To prevent an error condition on the parallel port from hanging 
up the system, a timeout loop is used. The length of the timeout is determined by the values 
stored in the timeout table. The timeout values for each of the parallel ports can be set 
independently of each other. 


7.2.3 Print Screen Driver Data Structures 


The print screen driver uses a single byte data structure, located at 0040:0100H (see Appendix 
B). The print screen driver places a status byte at this location, indicating whether or not a print 
screen operation is underway. The possible values for this status byte are: 


Data Definition 


The print screen driver has not been called or it completed the previous 


operation successfully. 
1 Printing Is In progress. 
OFFH Error occurred during printing. 


If this byte indicates a print screen operation is currently in progress, the driver will return. This 
prevents more than one print screen operation from occurring at the same time. 


7.3 Serial Port Driver (INT 14H) 


The functions supported by the serial port driver can be divided into two groups; those that set 
and report communication protocol or status, and those that transmit and receive data. The 
driver supports nine functions. Four of these functions implement the features of the industry 
standard INT 14H driver. The remaining five functions are EX-BIOS extensions. The ROM BIOS 
supports several features not found in the industry standard INT 14H driver. Among these 
features is the ability to select a communication speed of up to 19.2 K baud per second and the 
support of block (multi-byte) data transfer. 


The following is a list of descriptions for each of the INT 14H functions. A summary of these 
functions is shown in table 7.4. 
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Table 7.4 


Serial Port Driver Function Code Summary 


INT Function Function 
Hex Equate Value Definition 


14H INT__SERIAL Serial 
F14__ INIT OOH Initialize Serial Port Parameters 
F14__ XMIT O1H Send Out One Character 
Fi4__ RECV O2H Receive One Character 


F14__ STATUS O3H Get Serial Port Status 

F14__ INQUIRE 6FOOH EX-BIOS present 

F14__ EXINIT 6FO1H Initialize serial port (19.2 Kbaud) 

Fi4__PUT__BUFFER 6FO2H Write a buffer of data 

Fi4__GET__BUFFER 6FOQ3H Read a buffer of data 

F14_ TRM__BUFFER 6FO4H Read a buffer of data, terminate on specified 
condition 


Serial Port Driver Function Definitions 


All of the following functions range check (between 0 and 3 inclusive) the requested port 
number specified in the DX register. If legal, the function looks up the I/O address contained in 
the STD-BIOS data area. If the port table entry is non-zero the port is assumed to exist. If the port 
table entry is zero the function returns without altering any registers. 


F14__ INIT (AH = OOH) 
The initialize function, F14__INIT, sets the baud rate, number of stop bits, parity and character 


length of the specified serial port. On return it reports the current contents of the line status 
register and the modem status register of the specified port. 
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On Entry: AH = F14_INIT (OOH) 


AL = 


Bit 


Port attribute 


O7H-O5H 111 


110 
101 


O4H-03H xO 


02H 0 


01H-OOH 00 


DX = 
On Exit: AH = 
AL = 
Registers Altered: 


Data 


Definition 
9600 baud rate 
4800 baud rate 
2400 baud rate 
1200 baud rate 
600 baud rate 
300 baud rate 
150 baud rate 
110 baud rate 
no parity 

even parity 
odd parity 

1 stop bit 

2 stop bits 
undefined 
undefined 

7 bit character 
8 bit character 


Port number (0, 1, 2, 3) 


Line status (see table 7.5) 
Modem status (see table 7.6) 


AX 


Table 7.5 defines the Serial Port Line Status. 
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Table 7.5 


Line Status Register Report 


Bit Data Definition 


Timeout Error (Not applicable on F14__INIT, F14__EXINIT or 
F14__ STATUS) 

Transmit Shift Register Empty 

Transmit Hold Register Empty 


Break Received 
Character Framing Error 
Parity Error 

Overrun Error 

Data Set Ready 


Om NWAUIO) SN 


Table 7.6 defines the Serial Port Modem Status. 


Table 7.6 
Modem Status Register Report “~ 


Bit Data Definition 


Receive Line Signal Detected 
Ring Indicator Line State 

Data Set Ready Line State 

Clear to Send Line State 

Change in Receive Line Detected 
Trailing Edge of Ring Detected 
Change in Data Set Ready 
Change in Clear to Send State 


7 
6 
5 
4 
3 
2 
1 
0 
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Example: 


MOV AH, F14__JNIT , (AH = OH) 
MOV AL, 11100111B — ; HP Laserjet factory default 
; 9600 baud 
; No parity 
, 2 Stop bits 
, 8 bit character 
; setting 
MOV Dx, 0 ; Port 0 specification 
INT — INT__SERIAL ; Call serial driver (INT 14H) 


F14_ XMIT (AH = 01H) 


Transmits a data byte on the serial port specified by the DX register. The function enables 
the REQUEST-TO-SEND and DATA-TERMINAL-READY signals, and then waits on the 
DATA-SET-READY, CLEAR-TO-SEND, and REGISTER-EMPTY signals until the character Is 
transferred or a timeout occurs. 


On Entry: AH = F14__XMIT (01H) 
AL = Data byte to be transmitted 
DX = Port number (0, 1, 2, 3) 

On Exit: AH = Line status (see table 7.5) 
AL = Modem status (see table 7.6) 


Registers Altered: AX 
Example: 


MOV AH, F14_XMIT — ; (AH = 02H) 


MOV AL, ‘G’ , ASCII ‘G’ character to send 
MOV Dx, 0 ; Port 0 specification 
INT INT__SERIAL ; Call serial driver (INT 14H) 


TEST AH, 10000000B _— ; Check for error 
JINZ — short ERROR__HANDLER 
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F14_ RECV (AH = 02H) 


This function reads a data byte from the serial port specified by the DX register. The signal 
DATA-TERMINAL-READY is enabled in the modem control register indicating to the remote 

device that data can be sent. The modem status register signal DATA-SET-READY and the line a 
Status register signal DATA-READY are polled until a data byte is available to read or the timeout 

count has expired. 


On Entry: AH = F14_RECV (02H) 
DX = Port number (0, 1, 2, 3) 


On Exit: AH = Line status (see table 7.5) 
AL = If no error: Data byte received 
If error: Null character, zero 

Registers Altered: AX 
Example: 

MOV AH, F14__RECV _ ; (AH = 2) 

MOV Dx, 0 ; Port O specification 

INT — INT__SERIAL | ; Call serial driver (INT 14H) -~ 


TEST AH, 10000000B _ ; Check for error 
JNZ — short ERROR__RECEIVE 


F14_ STATUS (AH = 03H) 


This subfunction returns the status of the serial port specified by the DX register. 


On Entry: AH = F14_ STATUS (03h) 
DX = Port number (0, 1, 2, 3) 
On Exit: AH = Line status (see table 7.5) 
AL = Modem status (see table 7.6) 


Registers Altered: AX 


F14_ INQUIRE (AX = 6FOOH) 
This function determines whether or not the extended EX-BIOS functions are available. If the 


EX-BIOS functions are available, the BX register will be set to 4850H (which are the ASCII 
characters ‘HP’). 
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On Entry: AX 
BX 


On Exit: BX 


‘HP’ 


Registers Altered: AX, BX 


Example: 


MOV 
XOR 


INT 


JNE 


BX, BX 


INT__SERIAL 
CMP BX, ‘HP’ 


F14__ INQUIRE (6FOOH) 
Any value except 4850H (‘HP’) 


AX, F14__INQUIRE ; (AH = 6FOOH) 


, Clear out BX 
; Call serial driver (INT 14H) 
‘ Check? 


short ERROR__NO__EXTENDED__ FUNCTIONS 


F14__EXINIT (AX = 6F01H) 


This function Is similar to the STD-BIOS function, F14__INIT, but provides the ability to set a baud 
rate beyond 9600. 


On Entry: AX = F14__EXINIT (6FO1H) 
BX = Port attributes 


Bit 
O8H-O5H 


O4H-03H 


O2H 


01H-OOH 


Data 
1000 


Definition 


19200 baud rate 


9600 baud rate 
4800 baud rate 
2400 baud rate 
1200 baud rate 
600 baud rate 
300 baud rate 
150 baud rate 
110 baud rate 
no parity 

even parity 
odd parity 

1 stop bit 

2 stop bits 
undefined 
undefined 

7 bit character 
8 bit character 


DX = Port number (0, 1, 2, 3) 
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On Exit: AH 
AL 


Line status (see table 7.5) 
Modem status (see table 7.6) 


Registers Altered: AX 


Example: 
MOV AX, F14__EXINIT , (AH = 6F0O1H) 
MOV BX, 0000000100011010B _ ; Port attributes 
, 19.2 K baud 
; parity even 
; 1 stop bit 
, 7 bit character 
MOV Dx,1 ; Port 1 specification 
INT — INT__SERIAL ; Call serial driver (INT 14H) 


F14__PUT__BUFFER (AX = 6F02H) 


This function transmits data from a buffer as long as there is data in the data buffer and no error 
Is encountered. 


For each data byte transferred, the function enables the REQUEST-TO-SEND and 
DATA-TERMINAL-READY signals, and then waits on the DATA-SET-READY, CLEAR-TO-SEND, and 
REGISTER-EMPTY signals until the character is transferred or a timeout occurs. The timeout count 
is reset for each byte transferred. 


On Entry: AX = F14__PUT__BUFFER (6F02H) 
CX = number of characters in the data buffer 
DX = Port number (0, 1, 2, 3) 
ES:DI = Pointer to a data buffer of characters 
On Exit: AH = Line status (see table 7.5) 
AL = Modem status (see table 7.6) 


Normal Completion: 
CX = Number of bytes transferred successfully 
ES:DI Base of data buffer 


Error Completion (bit 7 of AH register non-zero): 
CX = Number of bytes transferred successfully 
ES:DI = pointer to next byte to be transferred 


Registers Altered: AX, CX, DI, ES 
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Example: 


STRING DB ‘Hello’ 


END__STRING: 

START: 
MOV AX, seg STRING ; set pointer to string 
MOV ES, AX 


MOV DI, offset STRING : 
MOV AX, F14__PUT__BUFFER , (AX = 6FO02H) 
MOV CX, END__STRING-STRING _ ; length of character 


; string 
MOV Dx, 0 ; Port O specification 
INT — INT__SERIAL ; Call serial driver 

, (INT 14H) 
TEST AH, 10000000B , test for errors 


JINZ — short ERROR__PUT__STRING 


F14__GET_BUFFER (AX = 6F03H) 


This function reads characters into the specified data buffer until the buffer is full or a timeout 
occurs. For each byte, the signal DATA-TERMINAL-READY is enabled in the modem control 
register indicating to the remote device that data can be sent. The modem status register signal 
DATA-SET-READY and the line status register signal DATA-READY are polled until a data byte is 
available to read or the timeout count has expired. 


On Entry: AX = F14__GET__BUFFER (6FO03H) 
CX = maximum buffer size 
DX = Port number (0, 1, 2, 3) 
ES:DI = Pointer to a data buffer 


On Exit: AH = Line status (see table 7.5) 


Normal Completion: 


AL = last byte read 
CX = Number of bytes transferred successfully 
ES:DI_ = Base of data buffer 


Error Completion (bit 7 of AH register non-zero): 


AL = 0, the null byte 
CX = Number of bytes transferred successfully 
ES:DI = pointer to next byte to be transferred 


Registers Altered: AX, CX, DI, ES 
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Example: 


IN__.BUFFER DB = 512 DUP (20H) 


END__BUFFER: 

START: 
MOV AX, seg IN__BUFFER ; set pointer to string 
MOV ES, AX : 
LEA DI, offset IN__BUFFER fi 
MOV AX, F14__GET__BUFFER , (AX = 6FO3H) 
MOV CX, END__BUFFER—IN__BUFFER ; length of character 

; string 

MOV Dx, 0 ; Port O specification 
INT — INT__SERIAL ; Call serial driver (INT 14H) 
TEST AH, 10000000B , test for errors 


JNZ — short ERROR__PUT__STRING 


F14_ TRM__BUFFER (AX = 6F04H) 


This function will read characters into the specified data buffer until any one of the following 
three conditions occurs: 


@ The data buffer is filled with characters. 
@ A character is read which is between the upper bound and the lower bound, inclusive. 
@ Anerror or timeout condition is encountered. 


For each byte, the signal DATA-TERMINAL-READY is enabled in the modem control register 
indicating to the remote device that data can be sent. The modem status register signal 
DATA-SET-READY and the line status register signal DATA-READY are polled until a data byte is 
available to read or the timeout count has expired. After the data byte is read it is inspected to 
see if it lies between the two boundary bytes. If the byte is in between the two bytes then the 
transfer is terminated. This function is useful for transferring logical records. 


On Entry: AX = F14__TRM__BUFFER (6F04H) 
BL = lower bound of termination character 
BH = upper bound of termination character 
CX = maximum buffer size 
DX = Port number (0, 1, 2, 3) 
ES:DI = Pointer to a data buffer 
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~ 


On Exit: AH = 


Line status (see table 7.5) 


Normal Completion Full Transfer: 


C) 
< 
How Wl 


last byte read 


Number of bytes transferred successfully 


Base of data buffer 


Normal Completion Terminate Character Detected: 


AL 
CX 
ES:DI 


last byte read (terminate byte) 


Number of bytes transferred successfully 


Base of data buffer 


Error Completion (bit 7 of AH register non-zero): 


'@) 
< 
Hou Tl 


Registers Altered: 


Example: 


IN_.BUFFER DB 


END__BUFFER: 
START: 


NOT__BETWEEN: 


O, the null byte 


Number of bytes transferred successfully 
pointer to next byte to be transferred 


AX, CX, DI, ES 


512 DUP (20H) 


AX, seg IN__BUFFER 

ES, AX 

DI, offset IN__BUFFER 

AX, F14__TRM__BUFFER 

CX, END__BUFFER—IN__BUFFER 


DX, O 
INT__SERIAL 


AH, 100000008 

short ERROR__PUT__STRING 
AL, BL 

NOT__BETWEEN 

AL, BH 

NOT__BETWEEN 


; set pointer to string 


4 


, (AX = 6FO4H) 

; length of character 
, string 

; Port O specification 
; Call serial driver 

; (INT 14H) 

, test for errors 


; lower bound? 


; upper bound? 


Serial and Parrallel I/O 231 


7.4 Parallel Port Driver (INT 17H) 


The parallel port driver provides several functions that support data transfer on the parallel ports 
and return status. These functions implement the features of the industry standard INT 17H 
driver and the EX-BIOS extended functions. The EX-BIOS functions implement features not found 
in the industry standard functions, such as block (multi-byte) data transfer. 


The following is a list of descriptions for each of the INT 17H functions. A summary of these 
functions is shown in table 7.7. 


Table 7.7 


Parallel Port Driver Function Code Summary 


INT Function Function 
Hex Equate Value Definition 


17H INT__PRINTER Printer 
F17__PUT__CHAR QOH Send printer one byte 


F17__INIT O1H Initialize printer port 

F17__ STATUS O2H Get printer port status 
F17__INQUIRE 6FOOH EX-BIOS present 
F17__PUT__BUFFER 6FO2H Write a buffer to printer port 


Parallel Port Driver Function Definitions 


The following functions range check (between 0 and 3, inclusive) the requested port address 
specified in the DX register. If legal, the function looks up the I/O address contained in the 
STD-BIOS data area. If the port table entry is non-zero the port is assumed to exist. If the port 
table entry is zero the function returns without altering any registers. 


F17__PUT__CHAR (AH = 00H) 


This function prints a character on the parallel port. Valid data is set up on the printer interface 
for at least 900 nanoseconds. If the BUSY signal indicates that the device is busy, it executes an 
INT 15H function F15__DEV__BUSY. When it returns from F15__DEV__BUSY, the function waits 
until the BUSY signal indicates the device is not busy. The function generates a 500 nanosecond 
data strobe and holds the data valid for at least 900 nanoseconds. The function returns with the 
port status in the AH register. 
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» 


™ 


On Entry: AH = F17__PUT__CHAR (00H) 


AL = Data byte to be transmitted 
DX = Port number (0, 1, 2, 3) 
On Exit: | AH = Printer port status (see table 7.8) 


Registers Altered: AH 


Table 7.8 defines the parallel printer port status byte. 


Table 7.8 


Printer Status 


Bit Data Definition 


Printer Busy 

Printer Not Busy 

Not ready for Data 

Data Acknowledged 

Out of Paper 

Printer Offline 

Printer On Line (Selected) 
/O Error 

Not Used 

Not Used 

Printer Error or Timed out 


7 
6 
5 
4 
3 
2 
1 
O 


=a x K = O- - oO —-— Oo 


Example: 


MOV AH, F17__PUT_.CHAR — ; (AH = OOH) 


MOV AL, ‘W’ ; character to print 
INT — INT__PRINTER ; Call printer driver (INT 17H) 
TEST AH, 000000018 ; test for error? 


JINZ — short ERROR__PRINT 


F17__INIT (AH = 01H) 


This function initializes a parallel printer port. It enables the PRINTER-SELECT signal and activates 
the PRINTER-INITIALIZE signal. The PRINTER-INITIALIZE signal is held active for at least 50 
microseconds. The function returns with the printer port status in the AH register. 
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On Entry: AH = F17__INIT (01H) 
DX = Port number (0, 1, 2, 3) 
On Exit: AH = Printer port status (see table 7.8) 


Registers Altered: AH 
Example: 


MOV AH, F17__INIT , (AH = 01H) 
INT — INT__PRINTER , Call printer driver (INT 17H) 
TEST AH, OO00001B ; Test for error 


F17_ STATUS (AH = 02H) 
This function returns the status of the specified parallel printer port. 


On Entry: AH 


F17__STATUS (02H 
DX 1 


(02H) 
Port number (0, 1, 2, 3) 


On Exit: | AH = Printer port status (see table 7.8) 


Registers Altered: AH 


F17__ INQUIRE (AX = 6FOOH) 


This subfunction determines whether or not the extended EX-BIOS functions are available. If the 
EX-BIOS functions are available, the BX register will be set to 4850H (which are the ASCII 
characters ‘HP’). 


On Entry: AX = F17__INQUIRE (6FOOH) 
BX = Any value except 4850H (‘HP’) 


II 
a 
= 


On Exit: BX 
Registers Altered: AX, BX 
Example: 


MOV AX, FI7_INQUIRE — ; (AH = 6FOOH) 


XOR BX,BXx , Clear out BX 
INT — INT__PRINTER ; Call printer driver (INT 17H) 
CMP BX,’HP’ , Check? 


JNE — short ERROR__.NO__EXTENDED__FUNCTIONS 
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F17__PUT__BUFFER (AX = 6F02H) 


This function transmits data from a buffer as long as there is data in the buffer and no error is 
encountered. Valid data is set up on the printer interface for at least 900 nanoseconds. If the 
BUSY signal indicates that the device is busy, it executes an INT 15H function F15__DEV__BUSY. 
When it returns from F15__DEV__BUSY, the function waits until the BUSY signal indicates the 
device is not busy. The function generates a 500 nanosecond data strobe and holds the data 
valid for at least 900 nanoseconds. The function returns with the port status in the AH register. 


On Entry: AX = F17__PUT__BUFFER (6F02H) 
CX = Number of characters in the data buffer 
DX = Port number (0, 1, 2, 3) 
ES:DI = Pointer to a data buffer of characters 
On Exit: AH = Printer port status (see table 7.8) 


Normal Completion: 
CX = Number of bytes transferred successfully 
ES:DI_ = Base of data buffer 


Error Completion (bit O of AH register non-zero): 
CX = Number of bytes transferred successfully 
ES:DI_ = pointer to next byte to be transferred 
Registers Altered: AH, CX, DI, ES 


Example: 


STRING DB ‘Hello’ 


END__STRING: 

START: 
MOV AX, seg STRING ; set pointer to string 
MOV ES, AX ‘ 
MOV DI, offset STRING ‘ 
MOV AX, F17__PUT__BUFFER , (AX = 6FO2H) 
MOV CX, END__STRING—STRING ; length of character 

; string 

MOV Dx, C ; Port O specification 
INT — INT__PRINTER ; Call printer driver (INT 17H) 
TEST AH, OOOO0001B ; vest for errors 


JNZ short ERROR__PUT__STRING 
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7.5. Print Screen Driver (INT 05H) 


The print screen driver prints the contents of the screen. Each time an INT O5H instruction is 
executed, the contents of the screen will be printed on the system printer (Port 0). If a print 
screen Operation is already in progress the driver returns without printing the contents of the 
screen. The print screen driver does not execute functions in the same manner as the other 
drivers. It performs a single task, so there are no functions. 


The print screen driver is called by the keyboard driver (INT 9H) when the scancode (O6AH) for 
the <Prt Sc> key is detected. In addition, application programs may execute an INT 05H 
instruction any time a copy of the contents of the screen is desired. 


The print screen driver can only print the contents of a screen if the display adapter is in one of 
its alphanumeric modes. 
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SECTION 8. DISC 


This section discusses the ROM BIOS disc drivers. The disc driver (INT 13H) provides a set of 
functions that control the disc drives and data transfer between the disc drives and the system. 


8.1 Overview 


The disc driver supports three disc types; standard capacity flexible discs (360KB), high capacity 
flexible discs (1.2 MB), and hard discs. The structure of the disc driver allows additional drives to 
be easily integrated into the system. 


The disc driver consists of two separate code modules; a module that supports flexible disc 
drives, and one that supports hard disc drives. The code module that provides the flexible disc 
support is contained in the ROM BIOS that resides on the Processor Extension Card. The code 
module for the hard disc drive is resident in a ROM on the hard disc adapter card. 


8.1.1 Physical Drive Numbers 


Each drive in the system has a physical drive number. Physical drive numbers for flexible discs 
start with 0, while physical drive numbers for the hard disc start with 80H. In a typical system 
configured with one high capacity flexible disc drive, one standard capacity flexible disc drive, 
and one 20MB hard disc drive, the physical drive numbers would be 0, 1, and 80H respectively. 
Flexible disc drives have a one-to-one correspondence between physical drives and volumes. 
However, hard disc drives may have more than one volume, and consequently more than one 
physical drive number. The optional 40MB hard disc drive can be configured as two 20MB 
volumes. A 40MB hard disc will have two physical drive numbers assigned to it (80H and 81H). 


Physical voluming of disc drives is not the same as operating system partitions, and the two 


should not be confused. See the Vectra MS-DOS Programmer's Reference Manual for more 
information on disc partitions. 
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8.1.2 Flexible Disc Drive Support 


The disc driver provides support for both standard and high capacity flexible disc drives. The disc 
driver supports dual format operation (i.e. reading and writing both types of flexible discs) in the 
high capacity disc drive(s). The flexible disc drives are supported with six functions that perform 
read, write, verify, reset, format, and return status tasks. 


8.1.3 Hard Disc Drive Support 


The system can be configured with an optional hard disc drive. When an internal hard disc drive 
is added to the system, the disc driver is ‘‘expanded”’ to include the functions contained in the 
BIOS code on the hard disc adapter card. 


The hard disc BIOS is integrated into the system during the system generation process (SYSGEN). 
Early in the SYSGEN process the software interrupt vector INT 13H is initialized to point to the 
flexible disc driver code module. Later in the SYSGEN process the address space between 
OC8000H and ODFFFFH is searched for option ROM modules. This search is explained in greater 
detail in Section 10. SYSGEN detects the hard disc option ROM and calls it to initialize. During 
this initialization process the hard disc driver links into the INT 13H disc driver chain. This process 
is explained in greater detail later in this section. 


When an INT 13H is executed the hard disc code is called first. The hard disc code checks the 
physical drive number specified. If it is a hard disc drive number (greater than or equal to 80H) 
the function is executed by the hard disc driver code module. If the physical drive number 
indicates a flexible disc drive (less than 80H), the hard disc code module passes control to the 
flexible disc driver code module by executing an INT 40H. 


8.1.4 External Disc Drives 


External disc drives can easily be added to the system. There are two methods for doing this. The 
external disc can supply BIOS code in an option ROM and enter the system in a manner similar to 
the internal hard disc. As an alternative, the system could use a DOS installable device driver. 
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Discs using installable device drivers can not be used as boot devices, since they are loaded in 
RAM by the operating system. Further, operating systems other than DOS may not recognize the 
disc in the system. For more information on installable device drivers consult the Vectra MS-DOS 
Programmer's Reference Manual. 


Using the option ROM entry mechanism described in the following section, the external hard disc 
becomes an integrated part of the system and Is treated as if it were an internal drive. The first 
physical hard disc drive, 80H, can then be used as the system boot device. 


8.1.5 INT 13H Disc Chain 


The INT 13H disc driver chain is a linked list of disc driver entry points. This chain accesses the 
BIOS based flexible disc driver and the hard disc driver. This linked list is configured during 
SYSGEN. The following description specifies how the disc chain is implemented and how it is 
created in the system. 


P 8.1.5.1 INT 13H Disc Chain Linkage 


The hard disc driver is linked into the INT 13H driver chain during the option ROM initialization. 
The process can be extended by other option ROM based disc adapters. The following is a 
description of how the HP hard disc ROM BIOS enters the INT 13H device chain during the 
option ROM initialization process. The relationship between the flexible and hard disc driver code 
modules is illustrated in figure 8.1. 


@ SYSGEN first configures INT 13H to point to the entry point of the flexible disc driver code. 


@ SYSGEN detects the hard disc driver's option ROM module and call the initialization entry 
point of the option ROM. 


@ The hard disc driver code initializes the disc adapter and the disc drive. 


a @ After the disc adapter hardware is initialized the disc drive is ready to install itself in the INT 
13H disc driver chain. The hard disc driver calls the INT 13H function F13___GET__HPARMS 
(08H) to determine how many other hard discs have entered the system. The lowest hard 
disc device number (80H) Is used for the call. If the call is successful, then the DL register 
contains the current number, ‘n’, of hard discs already linked in the INT 13H disc chain. If 
there are no other hard discs linked into the system, the call will return the status, bad 
command error, and the current number of drives ‘n’ is set to OOH. 
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Figure 8.1 
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INT 46H 


Flexible and hard disc code modules 


@® The hard disc driver calculates and saves its own starting device number. The device number 
is 80H + ‘n’ where ‘n’ is the current number of drives determined in the previous step. 


@ If this is the first hard disc configured in the system then the flexible disc driver address in INT 
13H (0:04CH) must be moved to INT 40H (0:100H). If this is not the first hard disc driver then 
the address of the previously added hard disc driver in INT 13H is saved in RAM for future 
calls to that previously linked driver. 
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@ The new hard disc driver entry point is loaded into INT 13H. Entry into the chain is complete. 


Note 


Many industry standard disc controllers (for example the IBM-PC/XT Fixed Disc 
Adapter) do not implement the disc drive chain mechanism in exactly the same way. 
However, the above definitions operate transparent to the industry standard if the HP 
disc adapter card is set to a memory address greater than IBM-PC/XT compatible 
adapters. 


When the hard disc initialization is complete the system hardware is reconfigured as follows: 
@ The STD-Slave controller's interrupt is enabled on the master 8259. 


@ The Hard Disc Interrupt (either the default IRQ 14H or the optional IRQ 15H) is disabled on 
the STD-slave 8259. 


@ The diagnostic bit is set in CMOS indicating whether the C: drive (physical device number 
80H) is usable as a boot device. 


8.1.5.2 Disc Access 


When a driver in the INT 13H chain Is called by either DOS or an application, the driver should 
compare the requested device number with the starting physical device numbers it supports. The 
driver takes one of the following four actions: 


@ |f the requested disc device is supported by this driver then the function is serviced by this 
driver. 


@ |f the driver is the first hard disc driver in the chain (physical device number 80H) and the 
requested device is less than 80H then the hard disc driver calls, via INT 40H, the flexible disc 
driver. 


@ If the driver is not the first hard disc driver in the chain the driver passes the function on to 
the next driver in the chain via a PUSHF, CALL FAR instruction combination which simulates 
an INT instruction. The address was previously saved in RAM during configuration of the 
chain. The exception to this rule is the F13__GET__HPARMS function which all hard disc 
drivers execute. 


The function F13__GET__HPARMS (08H) returns the total number of hard disc drives in the DL 
register regardless of an intended specific physical device number requested. Each chained INT 
13H hard disc driver checks all commands that are passed through for the F13__GET__HPARMS 
function. If this function is decoded then the chained driver intercepts the return parameters and 
adds the number of devices it is serving to the total being accumulated in the DL register. 


Disc 243 


@ |f this is the last hard disc driver in the chain and the requested physical device number is 
larger than this disc driver’s number then it will return a bad command error. 


8.2 Data Structures 


There are separate data structures for the hard disc and the flexible disc drivers. The flexible disc 
has three data structures. The diskette parameter table holds information necessary for 
initializing and supporting the NEC flexible disc controller chip. The diskette status table holds 
information about the status of the previous flexible disc operation. The diskette operation table 
contains various disc operating parameters such as drive status, flexible disc data transfer rate, 
etc. The hard disc has only one data structure. However, each hard disc driver maintains it’s own 
copy. The hard disc parameter table is similar to the flexible diskette status table. It contains the 
physical device characteristics for a particular hard disc attached to the system. 


8.2.1 Diskette Operation Table 


The diskette operation table is located in the STD-BIOS data area starting at memory location 
0040:008BH (0048Bh). It contains parameters used by the disc driver to perform its functions. 
Data stored in this table allow the high capacity drives to read or write either standard or high 
capacity flexible discs. The contents of the operating parameter table are listed in table 8.1. 


Table 8.1 


Diskette Operation Table 


Length 
Offset in Bytes Description 


Data transfer rate of previous operation 

Bit O is set to ‘1° for combined 360kb/1.2Mb diskette controller. 
Current media type table 

Work area to generate current media types 

Table of current head positions 


244 Disc 


‘a 


8.2.2 Diskette Parameter Table 


The diskette parameter table contains information that controls the overall operation of the 
flexible disc controller. This table is pointed to by INT 1EH (0:78H). A default table is provided in 
the ROM BIOS at address OFOOOH:OEFC7H. The parameters used to control the NEC flexible disc 
controller can be changed by providing a new diskette parameter table pointer in INT 1EH 
(0:78H). This is detailed in table 8.2. 


Table 8.2 


Diskette Parameter Table 


Length 
Offset in Bytes Description 


NEC Specify command byte 1: step-rate time and head unload 
time 

NEC Specify command byte 2: head load time and DMA mode 
Motor wait time 

Bytes per sector, O= 128, 1=256,2=512 

Last sector number on track 

Read/write gap length between sectors 

Data length for read/write operations 

Format gap length between sectors 

Format filler byte 

Head settle time after seek command 

Motor start time in ', seconds 


—) 


Ww 
— 
as ao = > — 2 — 3 a oA > =) —— 


8.2.3 Diskette Status Table 


The status table for the internal flexible disc driver begins at memory location 0040:003EH 
(0043EH) in the STD-BIOS Data Area. The contents of this table are listed in table 8.3. 
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Table 8.3 
Diskette Status Table 


Length 
Offset in Bytes Description 
Flag byte 
Motor status 


Motor turn off counter 

Status of previous diskette operation 

Status bytes returned by the NEC controller from the previous 
Operation 


8.2.4 Hard Disc Parameter Table 


The optional hard disc drive has a set of parameters which are quite different from the flexible 
disc. Therefore, the contents of the hard disc parameter table are not the same as its flexible disc 
counterpart. 


Each hard disc volume has its own disc parameter table. Thus, a system with a 20MB hard disc 
will have one table, while a system with a 40MB hard disc (configured as two 20MB volumes) 
will have two tables. The tables do not have a specific location in memory. Instead, two of the 
system interrupt vectors are used as pointers. These vectors must be initialized to point to the 
tables by the hard disc BIOS when it Is initialized. Interrupt vector 41H contains the address of 
the first hard disc table while interrupt vector 46H stores the address of the second hard disc 
table. The contents of the tables are listed in table 8.4. 
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Table 8.4 


Hard Disc Parameter Table 


Length 
in Bytes Description 


Total number of cylinders 
Total number of Read/Write Heads 
Reserved 


Starting cylinder for write precompensation 
Reserved 

Cylinder to use as landing zone 

Number of sectors per track 

Reserved 


8.3 Disc Driver (INT 13H) 


The following is a list of descriptions for each of the INT 13H functions. All registers not specified 
in the exit parameters are returned unchanged. Following the function description is a list of the 
return status codes used by the INT 13H drivers. A summary of these functions is shown in table 
8.5. 
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Table 8.5 


Disc Driver Function Code Summary 


INT Function Function 
Hex Equate Value Definition 


13H INT__DISC Disc Functions 
F13_ RESET__ DISC OOH Reset Disc 
F13__RD__LSTATUS O1H Read Status of Last Operation 
F13_ RD__SECTORS O2H Read Sectors 
F13__WR__SECTORS O3H Write Sectors 


F13__ VR__SECTORS O4H Verify Sectors 
F13__ FORMAT__FLEX OSH Format Flexible Disc Track 
O6H Reserved 


Fi3_ FORMAT__HDISC O7H Format Hard Disc 
F13__ GET__HPARMS O8H Hard Disc Parameters 


O9H-OBH Reserved 
F13__ TRACK__SEEK OCH Seek to Track 
F13__ALT__RESET ODH Alternate Hard Disc Reset 
OEH-O0O14H Reserved 
F13__GET__DASD 15H Read Disc Type (DASD) 


F13_ CHG__STATUS 16H Get Disc Change Line Status 
F13__ SET__DASD 17H Disc Type for Formatting (DASD) 


Disc Driver Function Definitions 


Fi3_ RESET_DISC (AH = OOH) 


All discs in the INT 13H device chain are reset. A reset command is issued to each hard disc 
adapter in the system. For the flexible discs the Read/Write heads are recalibrated back to track 0 
and the software services are re-initialized. This call should be used after an error occurs while 
using the disc. This function does not write on a disc loaded in the flexible disc drive. 


On Entry: AH 
DL 


F13_ RESET__DISC (OOH) 
physical device number te, 


if DL < 80H then reset flexible discs 
if DL = 80H then reset all discs 
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On Exit: AH = return status 


Registers Altered: AH 


F13_ RD__LSTATUS (AH = 01H) 


The status of the last disc operation performed is preserved until the next operation occurs. This 
function will return the value stored as the status of the last operation. 


On Entry: AH 
DL 


F13__ RD__LSTATUS (01H) 

device number 

if DL < 80H then return flexible disc status 
if DL = 80H return hard disc status 


On Exit: AH = Status from the last disc operation 


Registers Altered: AX 


F13_ RD_SECTORS (AH = 02H) 


Based on the supplied parameters one or more sectors are transferred from the disc into system 
memory. It is the programmer's responsibility to insure that the data area provided is large 
enough to contain the requested data. For the hard disc, the maximum data request is 128 
sectors (at 512 bytes per sector) or 64KB of data. For the system to transfer the maximum 
amount of data the programmer must supply a buffer address that is paragraph aligned (address 
mod16 = 0) otherwise the DMA Boundary error will be returned. For data requests that are less 
than the maximum there are no addressing restrictions. 


For the flexible disc the maximum sector request is the total number of sectors per track. This 
number varies depending on the drive and media type being used (see the table in the parameter 
section). Data can only be read from one track at a time. To read data from another track, 
another read command must be issued with the appropriate parameters. 


At least three retries of a flexible disc driver command should be made before an error is 
indicated. Each retry should be preceded by a reset command, i.e., F13__RESET__DISC. 


Disc 249 


On Entry: AH 
AL 


Fi3__RD__SECTORS (02H) 
number of sectors to transfer 


For hard discs the sector range is 1-128 assuming 512 byte sectors 


For flexible discs the following formats are recognized: 


Media Sector Range 

320KB 1-8 

360KB_ 1-9 

1.2MB 1-15 
DL device number (Flexible < 80H Hard disc > = 80H) 
head number (0-15 not verified) 
track/cylinder number (not verified) 
For hard discs the high two bits of CL are the MSB of the cylinder number in 
CH, making a 10 bit value. The valid range is therefore O-1023. For the 
flexible discs the valid ranges are: 


UO 
=e 
No ul 


CH 


Media _ Track Range 


320KB 0-39 
360KB 0-39 
1.2MB 0-79 


CL = sector number (not verified) 
For the hard disc the valid value range is 1-17. 


For the flexible disc the values in the Sector Range column are also the valid 
input values for this parameter. 


ES:BX = address of data buffer for transfers 
On Exit: AH = Return Status Code (See table 8.7) 


Registers Altered: AX 


250 Disc 


a 


Example: 


MOV CxX/3 ; retry count 
UNTIL__RETRIED: 
PUSH CX ; save retry count 
MOV AH,F13__RD__SECTORS _ ; read a sector 
MOV AL,1 ; transfer 1 sector 
MOV DL,O ; Driver A: 
MOV DH,O ; head 0 
MOV CHO ; track O 
MOV CL,4 ; sector 4 
PUSH CS ; use current code segment 
POP ES ; as the segment of the data 
MOV BX,200H ; buffer offset 200H 
INT 13H ; call disc drivers 
POP CX ; restore retry count 
JNC NO__ERROR ; exit, all OK! 
MOV AH,FI3__RESET__DISC _ ; reset all drives 
INT 13H ; call disc drivers 
LOOP UNTIL__RETRIED ; loop till no count,no error 
; report error Is real to 
; application/user 


NO__ERROR: 


F13_ WR_SECTORS (AH = 03H) 


This function parallels the read function. Data is written from memory to the disc. See the 
description of the F13__RD__SECTORS function above. 
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On Entry: AH = F13__WR_SECTORS (03H) 
AL = number of sectors to transfer 


For hard discs the sector range is 1-128 assuming 512 byte sectors 


For flexible discs the following formats are recognized: 


Media Sector Range 
320KB 1-8 
360KB 1-9 
1.2MB 1-15 
DL device number (Flexible < 80H, Hard disc > = 80H) 
head number (O—15 not verified) 
track/cylinder number (not verified) 
For Hard discs the high two bits of CL are the MSB of the cylinder number in 
CH, making a 10 bit value. The valid range is therefore 0O-1023. 
For the flexible discs the valid ranges are: 


UO 
= 
Hon 


CH 


Media Track Range 


320KB 0-39 
360KB Q-39 
1.2MB OQ-79 


CL = sector number (not verified) 
For the hard disc the valid value range is 1-17. 


For the flexible disc the values in the Sector Range column are also the valid input 
values for this parameter. 


ES:BX address of data buffer for transfers 


On Exit: AH = Return Status Code (See table 8.7) 


Registers Altered: AX 


F13_ VR_SECTORS (AH = 04H) 


This function performs a read function without transferring any data. This function ensures that 
the track and sector can be located on the disc, that the error correction circuitry (CRC) Is 
working correctly and that the data can be read. Again, the discussion for F13__RD__SECTORS 
applies to this function. 
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On Entry: 


On Exit: 


AH 
AL 


DL 


CH 


F13__ VR__SECTORS (04H) 
number of sectors to transfer 


For hard discs the sector range is 1-128 assuming 512 byte sectors 


ror flexible discs the following formats are recognized: 


Media Sector Range 


320KB 1-8 
360KB_ 1-9 
1.2MB 1-15 


device number (Flexible < 80H, Hard disc > = 80H) 

head number ( 0-15 not verified ) 

track/cylinder number (not verified) 

For Hard discs the high two bits of CL are the MSB of the cylinder number in 
CH, making a 10 bit value. The valid range is therefore 0O-1023. 

For the flexible discs the valid ranges are: 


Media Track Range 


320KB 0-39 
360KB 0-39 
1.2MB Q-79 


CL = sector number (not verified) 


For the hard disc the valid value range is 1-17. 


For the flexible disc the values in the Sector Range column are also the valid input 
values for this parameter. 


AH = Return Status Code (See table 8.7) 


Registers Altered: AX 


F13_ FORMAT__FLEX (AH = 05H) 


This function writes a pattern of the sectors on a track of the flexible disc. One entire track is 
formatted at a time, but the programmer can control the characteristics of each sector and the 
number of sectors in each track. To control the sector variables the programmer supplies a table 
that has one entry for each sector in the track being formatted. The entries are the sector 
headers that the drive hardware uses. Also embedded in each entry is a code indicating the 
desired sector size. (512 bytes is standard). 
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F13__SET__DASD (AH = 017H), which sets the DASD type, must be called prior to calling the 
F13__ FORMAT__FLEX function. The Set DASD type function will ensure that the internal tables 
are correctly setup for the media/drive combination desired. 


The programmer is also responsible for setting two values in the diskette parameter table. In 
formatting either 320KB or 360KB media the programmer must set the format gap length to 
50H. The End of Track (EOT) value must be set to eight (8) for 320KB media or nine (9) for 
360KB media. When the format is complete the programmer should restore the two locations to 
their original values. The diskette parameter table is described in table 8.2. 


On Entry: AH = 
AL. i= 


DL 


O 
mo 
HW ot Wl 


CH 
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F13__ FORMAT__FLEX (05H) 
number of sectors to create 
For flexible discs the following formats are standard: 


Media Total Sectors 


320KB 8 
360KB 9 
1.2MB 15 


device number (0-1) 

head number (O—1 not verified) 

track number (not verified) 

For the flexible discs the valid ranges are: 


Media _ Track Range 


320KB 0-39 
360KB 0-39 
1.2MB 0-79 


sector number (not verified) 


For the flexible disc the values in the Sector Range column are also the valid 
input values for this parameter. 


Media Sector Range 


320KB_ 1-8 
360KB_ 1-9 
1.2MB 1-15 


ES:BX = Data buffer containing the values for the sector headers for the track being 
formatted. Each record is four bytes in length and there must be one record 
entry for each sector in the track being formatted. The records contain: 


(Track, Head, Sector,Length) 


Track = Current track number 
Head = Current head number 
Sector = Sector number 
Length = Coded sector length 

00 = 128 

OT =:.256 

02 -= 512 

03 = 1024 


On Exit: AH = Return Status Code (See table 8.7) 


Registers Altered: AH 


F13_ FORMAT__HDISC (AH = 07) 


This function formats the entire hard disc. Once started, this operation cannot be stopped, it 
must run to completion. This function accepts a table as a parameter that indicates the interleave 
factor to use for each track of the disc. 


On Entry: AH = F13__FORMAT__HDISC (07H) 
DL = device number (> = 80H) 
ES:BX = Interleave description table 


The table is 2*(sectors/track) bytes long. Each table entry is two bytes in 
length. The entries specify the ordering of the sectors for each track on the 
disc. The first byte of each entry is reserved and should be set to zero. As an 
example, a table for seventeen sectors per track with an interleave of two is 
shown in table 8.6. 
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Table 8.6 


Physical to Logical Sector Conversion 


Physical Sector Logical Sector 


OOH,O1H 
OOH,OAH 
OOH ,O2H 
OOH,OBH 
OOH ,O3H 


OOH ,OCH 
OOH ,O4H 
OOH,ODH 
OOH ,O5H 
10 OOH,OEH 


OOH ,OQ6H 
12 OOH ,OFH 
13 OOH,O7H 
14 OOH,10H 
15 OOH ,O8H 


OOH,11H 
OOH ,O9H 


WON AD) UBWN — 


On Exit: AH = Return Status Code (See table 8.7) 


Registers Altered: AH 


F13__GET_HPARMS (AH = 08H) 


This function gets a description of the physical characteristics of one of the hard discs. It also 
returns the total number of hard discs available through the INT 13H interface. 


On Entry: AH = F13__GET__HPARMS (08H) 
DL = device number (> = 80H) 
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On Exit: AH Return Status 


DL = # of drives in system 

DH = Maximum head address (Total heads — 1) 
CH = Maximum cylinder address (Total cyls — 1) 

CL = Maximum sector address (Total sectors/track) 


high two bits of CL are the MSB of the cylinder number in CH, making a 10 bit 
value 


Registers Altered: AH, CX, DX 


F13__ALT__RESET (AH = ODH) 


This command issues a reset command to the hard disc controller. It is essentially the same as 
function OH, F13__RESET__DISC, except that a reset is not issued to the flexible disc units. 


On Entry: AH = F13__ALT__RESET (ODH) 
DL = device number (> = 80H) 


On Exit: AH Return Status 


Registers Altered: AH 


F13__GET_DASD (AH = 15H) 


This function returns the Direct Access Standard Device (DASD) type code for the attached 
device. It also returns the total number of sectors for the entire drive if it is a hard disc. 


On Entry: AH = F13__GET__DASD (15h) 
DL = device number 
On Exit! AH = DASD type (if Carry Flag not set) 


O= No drive present 

1 = Flexible disc, no disc change line available 
2 = Flexible disc, disc change line is available 
3= Hard disc 


When AH = 3 the following registers are valid: 


CX 
DX 


Most significant word for total number of sectors on medium 
Least significant word for total number of sectors on medium 


Registers Altered: AH, CX, DX 
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F13_ CHG_ STATUS (AH = 16H) 


If the flexible disc drive supports a disc change line then this function reports the status of the 
disc change line. If the routine indicates that the disc has been changed then the programmer 
must take the appropriate actions to update the system to use the new media placed in the 
drive. The 1.2MB drive supports a disc change line. 


On Entry: AH = F13__CHG_ STATUS (16H) 
DL = device number (0-1) 
On Exit. © AH = 00 = disc change line not active 


06 = disc change line active, Carry Flag will be set 


Registers Altered: AH 


F13_ SET_DASB (AH = 17H) 

This function must be called before the format function (AH = 05H) can be used to format a 
flexible disc. Based on the DASD type passed in as a parameter, registers in the flexible disc 
controller are initialized for the programmer. 


On Entry: AH = F13__SET__DASD (17H) 


AL = DASD type code 
00 = not used 
01 = 320KB/360KB media in 320KB/360KB drive 


320KB/360KB media in 1.2MB drive 
03 = 1.2 MB media in 1.2MB drive 
DL = device number (0-1) 


ce) 
N 
Hol 


On Exit: AH = Return Status 


Registers Altered: AH 


8.4 Return Status Codes for INT 13H 


There are two status signals returned to an INT 13H programmer. The first is the Carry Flag in the 
Processor Status Word. If any kind of error occurs this flag is set ("'1"’). If the function was 
successful then the Carry flag is cleared ('0"’). 
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The second status returned to the programmer is in the AH register. The register will be loaded 
with one of the return codes shown in table 8.7. 


Table 8.7 
STD-BIOS Disc Return Status Codes 


Hex Value indication 


Successful execution, no error 

Unknown or bad command, bad device number 
Address mark could not be found 

Attempted to write on write protected disc 
Requested sector could not be found 


Reset function failed 

Initialization failed 

DMA overrun, Requested transfer would run over a physical 64KB 
boundary in RAM (flexible disc) 

DMA overrun, Requested transfer would run over a physical 64KB 
boundary in RAM (hard disc) 

Bad CRC encountered on flexible disc read 


Controller has failed 

Attempted Seek failed 

Time out occurred during disc operation 
Disc Drive reports “Not Ready” 
Undefined error occurred 
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9. SYSTEM DRIVERS 


This section contains a description of the drivers which control the system functions. The drivers 
discussed in previous sections deal with system peripherals such as the disc drives, keyboard, 
video display adapter, etc. The drivers covered in this section control the system itself. 


9.1 Overview 


The system drivers are designed to provide program access to system operating parameters, and 
to support ROM BIOS drivers. These drivers allow programs to determine the system equipment 
configuration and amount of memory, provide “hooks” for future multi-tasking capability, 
contro! vectors in the HP__VECTOR__TABLE, allocate RAM in the EX-BIOS data area, control 
system strings, manage CMOS memory, and perform system clock functions. An overview of the 
capabilities of the drivers in each of these categories follows. 


9.1.1 Memory Size And Equipment Determination 


The ROM BIOS supports two industry standard drivers that report the current system equipment 
configuration and memory size. These tasks are supported by the INT 11H and INT 12H drivers, 
respectively. 


The equipment determination driver (INT 11H) returns a word that describes the current system 
configuration. The definition of each bit or group of bits in the word is discussed later in this 
section. The number of printer ports, serial ports, presence of an 80287 math coprocessor, initial 
video display mode and number of flexible disc drives are reported by this driver. The default 
system configuration Is read from a CMOS memory location during power-on. If this information 
does not match the current configuration, a power on error message is issued and the current 
configuration is saved for the INT 11H driver. 
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The memory size driver (INT 12H) returns a word that indicates the number of 1 KB blocks of 

system RAM present. The amount of memory reported does not include any extended memory, 

and is adjusted to exclude the amount of RAM occupied by the EX-BIOS data area. For example, 

in a system equipped with 640 KB of system RAM using a 4 KB EX-BIOS data area, the amount 

of memory reported by this driver will be 636 KB. The default amount of memory is read from a 

word of CMOS memory. ~ 


9.1.2 Extended System Support 


The extended system support driver (INT 15H) provides support for several advanced system 

features. It provides “hooks” that allow programs to be written to support multi-tasking at a 
future date. In addition, it allows data to be transferred to and from extended memory, and 

allows placing the 80286 into its protected mode of operation. 


9.1.3 EX-BIOS Driver Support 


The V__SYSTEM driver is an EX-BIOS driver that provides support tasks for the EX-BIOS drivers. It 
contains functions that allocate RAM in the EX-BIOS data area and manipulate 
HP__VECTOR_TABLE entries. 


9.1.3.1 RAM Allocation 


The EX-BIOS data area contains three major data structures; the HP__VECTOR__TABLE, the 

global data area, and the driver's data area. Within each driver's data area is the driver header, 

describe record (if applicable), and variable storage area. Each entry in the HP__VECTOR__TABLE 

is three words long and consists of: Driver's IP, CS, and DS in that order. The HP__ENTRY__CODE 

(INT 6FH) loads the appropriate driver's data segment DS and jumps to the address CS:IP. 

The global data area is used by system drivers that need to share data. Data structures like the =” 
EX-BIOS stack and memory management pointers are maintained here. 
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The driver data area for each driver is dynamically allocated by the V__SYSTEM driver. Each 
driver's data area is at its data segment (DS) and is generally composed of a standard header 
followed by any data particular to the driver. If the driver wishes a data area from the EX-BIOS 
memory it must follow the allocation process described below. 


Space is allocated starting from the base of the global data area toward the top of the 
HP__VECTOR__TABLE as shown in figure 9.1. When a driver is initialized, the base address of the 
last driver data area (‘last used DS"’) is passed to the driver. The driver decrements this value by 
the number of paragraphs (16 bytes) it needs for its data area, then returns this value as the new 
“last used DS". 


Driver Data Area Allocation 


HP_VECTOR__TABLE 
HP_ENTRY__CODE 


EX-BIOS 
Memory 
Pool 


HP_VECTOR__TABLE 
HP__ENTRY’s CS:0 


HP_ENTRY__CODE 
HP__ENTRY’s CS:IP 


“Max DS”’ 


EX-BIOS 
Memory 
Pool 


“‘Last used DS”’ 


EX-BIOS Resident 
Driver’s Data 


Segments 
V__SYSTEM’s DS 
EX-BIOS Global 
Data Segment 
TOP of RAM 
Figure 9.1 


If a driver needs a particularly large data area, there might not be enough room. The driver must 
determine the amount of RAM it requires, then see if that amount is available by comparing its 
requirements against the amount of RAM available (’‘last used DS’’—’’Max DS’). 


If there is an insufficient amount of RAM available, the driver may increase the amount of RAM 
allocated to the EX-BIOS data area in the following manner. The memory size stored in CMOS 
RAM Is the amount of physical RAM less the amount occupied by the EX-BIOS Data Area. When 
the system is booted, the boot code determines the amount of physical memory, then subtracts 
the ‘top of memory” stored in CMOS RAM to determine how much space to allocate for the 
EX-BIOS Data Area. Adjusting the memory size in CMOS RAM downward, then rebooting will 
increase the size of the EX-BIOS Data Area and hence the amount of RAM available to the driver. 
This technique may be used to create an EX-BIOS data area up to 64 KBytes in size. A program 
listing demonstrating this process follows. (Functions F_RAM__GET, F_.RAM__RET, 
F__CMOS__GET and F_CMOS__RET are described in detail later in this section). 
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Example 


266 System Drivers 


MOV BP, V__SYSTEM 
MOV AH, F__RAM__GET 
INT HP__ENTRY 
DEC BX 
DEC BX 
DEC BX 
CMP BX, DX 
JA OK 

NOT__ENOUGH__RAM: 

MOV BL, 15H 

MOV AH, F__CMOS__GET 
MOV BP, V__SYSTEM 

INT HP__ENTRY 

DEC AL 

PUSHE 

MOV BL, 15H 

MOV AH, F_.CMOS__RET 
MOV BP. V__SYSTEM 

INT HP__ENTRY 

POPF 

INC RESET__ PROCESSOR 
MOV BL, 16H 

MOV AH, F__CMOS__GET 
MOV BP. V__SYSTEM 
INT HP__ENTRY 

DEC AL 

MOV BL, 16H 

MOV AH, F__CMOS__RET 
MOV BP. V__SYSTEM 

INT HP__ENTRY 


; How much memory available in 
: EX-BIOS data area? 

, F_RAM__GET returns: 

; BX = “last used DS” 

: DX = “Max DS” 


; Allocate 3 paragraphs (48 bytes) 
; application requires 44 bytes but 
, must allocate in full paragraphs 


, New “last used DS’’— ‘Max DS” 


, CMOS bytes 16H, 15H contain 
, “top of memory”’ 

; value (in 1 KB units) 

; Get least significant byte 


; Free up 1KB memory for 
, EX-BIOS data area 


; Store new “‘top of memory” in CMOS 


, lf necessary, decrement most 
; significant byte 


RESET__PROCESSOR: ; Reboot system. 
; This time with 1KB more 
CALL FAR PTR OFFFFH:0H ; memory allocated to the 


; EX-BIOS data area 
OK: 
MOv BP, V__SYSTEM ; Set new “last used DS” 
yand “Max DS” 
MOV AH, F__RAM__RET ; Memory ts allocated 


INT HP__ENTRY 


9.1.3.2 HP__VECTOR_ TABLE Manipulation 


All drivers in the EX-BIOS code module are accessed through the HP__VECTOR__TABLE. 

The V__SYSTEM driver provides a set of functions which allows the entries in the 
HP__VECTOR_TABLE to be set and/or modified. There are nine functions, which represent the 
permutations of three parameters. 


The first parameter determines whether a vector is to be inserted or exchanged with values 
passed in the 80286 registers. Vectors are typically inserted into the HP__VECTOR__TABLE during 
the boot process, whereas vector exchanges are used to implement driver mapping. For example, 
the V_QWERTY keyboard translator driver is installed in the HP__VECTOR__TABLE during the 
boot process. If keyboard scancodes from the QWERTY keypad were to be mapped to a Dvorak 
translator, the IP, CS, and DS of the Dvorak translator driver would be exchanged with the 
existing vector (so the vector could be restored to its original value at a later time). 


The second parameter is the vector type. The HP__VECTOR_TABLE has three types of vectors; 
fixed, reserved, and free. Fixed vectors are those assigned to the default EX-BIOS drivers. The first 
51 vectors in the HP__VECTOR__TABLE are fixed. Reserved vectors are set aside for future 
expansion. There are 24 reserved vectors, which are located at vector addresses 138H through 
1C8H inclusive. Free vectors are provided to allow user-supplied drivers to be added to the 
system. 


The final parameter involves the Data Segment (DS) of the driver. Drivers may allocate their data 
areas from the EX-BIOS data area as explained above, they may provide their own, or use the 
global data area of the EX-BIOS. The EX-BIOS drivers all use the DS allocation functions, while an 
external driver (for example, one installed as an MS-DOS device driver) may supply their own data 
area external to the EX-BIOS data area. Drivers supplying their own DS must pass it as a 
parameter to V__SYSTEM when the driver has completed initialization. 
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9.1.3.3 System String Control 


The EX-BIOS provides a centralized and flexible mechanism for accessing and using strings. Each 
string in the system has a unique index number associated with it. Drivers and application 
programs can request access to a string via these indices. In addition, functions are available to 
return the index of a given string, return the next available index, and to add and delete strings 
from the system. 


A string index may be any word value (O—OFFFFH). Certain ranges of indices have predefined 
meanings or uses. These predefined ranges are listed below. 


O—2K ~~ Any index in this range is reserved for string names of EX-BIOS drivers. 

2—4Kk _ This range is reserved for strings stored in the ROM-BIOS. 

4—32K This range should be used by application programs to add strings to the 
system. 

32—64K These Indices are reserved for localized strings. Indices within this range are 
partitioned in the same way as in the lower 32K (i.e., 32—34K for string 
names of EX-BIOS drivers, etc.). 


This index structure provides a powerful tool for localizing application programs. If an application 
program references messages as string indices, the program can easily be localized by loading a 
localized set of strings (using a device driver for example), and setting bit 15 of all string indices 
used. 


System strings are grouped into buckets. A bucket is a collection of strings which are grouped 
together. There is no fixed limit on the number of strings which may be stored in a bucket. 
However, strings are added and deleted in buckets, not individually. Therefore, strings that are 
likely to be added or deleted together should be stored in the same bucket. 


Each bucket consists of three separate data structures; the bucket header, bucket pointers, and 
the bucket itself. These components are illustrated in figure 9.2. The function of each is 
described below: 


Bucket Header—The bucket header is the top level data structure. All bucket headers are 

linked together in a chain. The first two fields in the header contain the offset and segment 
of the next bucket header in the chain. If these fields both contain OFFFFH, then this bucket 
header is the last in the chain. The highest and lowest string indices contained in the bucket 


are stored in the next two fields. The following two fields contain the offset and segment of 


the bucket pointer. Finally, the last field contains the segment of the strings themselves. 
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Bucket Pointer—The bucket pointer consists of a series of offsets to the strings in the 
bucket. There must be one offset for every index in the range specified in the bucket 
header. The actual address of the string is determined by the segment (which is stored in 
the bucket header) and the offset stored in the bucket pointer. Note that all strings in a 
bucket must be in the same segment. 


Bucket—The bucket contains the actual strings. Each string consists of a byte containing the 
number of characters in the string, the string itself, and a null byte (OOH) which serves as a 
string terminator. 


String control is accomplished through the appropriate functions in the V__SYSTEM driver. These 
functions provide complete control over system strings. 


9.1.4 CMOS Memory Control 


The system contains a CMOS Memory/Clock chip that serves as a real-time clock and provides 64 
bytes of non-volatile memory storage. The CMOS RAM is used to store system parameters. The 
contents of the CMOS RAM are listed in Appendix C. 


The CMOS Memory/Clock is accessed through two I/O ports. One port selects the clock register 
or memory byte to access, and the other is a bidirectional data port. There are a total of 64 
addresses in the CMOS Memory/Clock chip; the first 14 are the clock registers, while the 
remaining 50 are the CMOS RAM. 


The V__SYSTEM driver contains two functions which support reading and writing data to the 
CMOS Memory/Clock. These functions provide a simple access to the contents of the chip. 


9.1.5 System Clock Functions 


The system employs two separate clock systems to keep track of the time and date. The first is 
the CMOS Memory/Clock. The CMOS clock has a battery back-up which allows it to keep track 
of the current time when the system is turned off. 
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System String Data Structures 
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ert ‘ 
Figure 9.2 
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The second clock is a software clock. It uses Channel 1 of the 8254 counter/timer chip (refer to 

the Vectra Technical Reference Manual, Volume | for additional details). Channel 1 of the 8254 

generates a hardware interrupt (IRQ 0) approximately 18.2 times per second. The ROM BIOS 

keeps time by incrementing a software clock each time the interrupt occurs. The software clock 
is used by the operating system for such tasks as time and date stamping of files. 


The two clocks operate independently except at boot time. During the boot process the current 
time and date maintained by the CMOS clock is read and used to initialize the software clock. 
Changing the value of CMOS clock will not affect the software clock until the system is 
rebooted. 


The STD-BIOS clock driver (INT 1AH) provides a convenient way to read or set the time and date 
from either of the system clocks. These functions are detailed later in this chapter. 


In addition to keeping time, both clocks issue interrupts that call user or application program 
routines. The software clock interrupt service routine performs an INT 1CH each clock tick. If this 
vector is modified to point to a user routine, the routine will be called on each clock tick. 


The CMOS clock has an “alarm clock” feature. It can be programmed to issue an interrupt at a 
specified time. The real-time clock hardware issues an INT 4AH each time the alarm timer is 
done. The interrupt 4AH vector can be modified to point to a user-supplied routine. 


9.2 Data Structures 


The system drivers use several data structures. The data structures for the STD-BIOS system 
drivers are contained in the STD-BIOS data area, while those used by the EX-BIOS drivers are in 
the EX-BIOS data area. 


The STD-BIOS system drivers use four data structures. The memory size and equipment 
determination drivers each use a word, the ROM software clock uses five bytes. These data 
structures are located at 040:13H, 040:10H, and 040:6CH respectively. The extended system 
support driver uses 9 bytes starting at location 040:98H. The EX-BIOS system drivers use the 
global data area. These data structures are described in detail in Appendix B. 
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9.3. Equipment Determination Driver (INT 11H) 


Returns information about the equipment attached to the system. 


On Entry: No Inputs. 


On Exit: = AX = Word with all equipment information: 


Bit 

15, 14 
ie aa 
Ey 10,9 
8 

7,6 


3,4 


Registers Altered: AX. 


Value 


Definition 

Number of printers attached. 
Not used. 

Number of datacomm cards attached. 
Not used. 

Number of diskettes attached: 
1 drive, 

2 drives, only if Bit 0 Is also a 1 
Initial video mode selected: 
Other. 

40x25 color adapter. 

80x25 color adapter. 

80x25 monochrome adapter. 
Not used. 

Math co-processor attached. 
Diskette drives attached. 


9.4 Memory Size Determination Driver (INT 12H) 


Returns the amount of RAM found in the system during the power-on and initialization routines. 


On Entry: No Inputs. 


On Exit: AX = Number of 1KB memory blocks found. 


Registers Altered: AX 
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9.5 System Support Driver (INT 15H) 


The extended system support driver (INT 15H) provides functions which allow data to be 
transferred to and from extended memory and allow placing the 80286 into its protected mode 
of operation. These functions are listed in table 9.1. 


Table 9.1 


System Support Driver Function Code Summary 


INT Function Function 
Hex Equate Value Definition 


15H_ INT__SYSTEM System Functions Interrupt 
Q-3 Unsupported 
F15__ DEVICE__OPEN 80H Device Open 
F15_ DEVICE__CLOSE 81H Device Close 
F15__ PROG__TERM 82H Program Termination 
F15_ WAIT__EVENT 83H Event Wait 
F15_ JOYSTICK 84H Joystick Support 
F15__SYS_ REQ 85H System Request Key Pressed 
F15__ WAIT 86H Wait Fixed Amount of Time 
F15__ BLOCK__MOVE 87H Move Block of Memory to/from 
Extended Memory 
F15__ GET_®%MEM_SIZE 88H Get Extended Memory Size 
F15_ ENTER__PROT Switch to Protected Mode 
F15__ DEV__BUSY Device Busy Hook 
F15__INT__COMPLETE 91H Set Interrupt Completed Flag 


System Support Driver Function Definitions 


F15_ DEVICE. OPEN (AH = 80H) 


Open device for I/O. This is a hook for multitasking systems. Currently the function just returns. 


On Entry: AH = F15__DEVICE__OPEN (80H) 
BX = Device Identifier 
CX = Process Identifier 
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On Exit: | No values returned. 


Registers Altered: None. 


F15_ DEVICE CLOSE (AH = 81H) | 


Close device for I/O. This is a hook for multitasking systems. Currently the function just returns. 


On Entry: AH = F15__DEVICE__CLOSE (81H) 
BX = Device Identifier 
CX = Process Identifier 


On Exit: No values returned. 


Registers Altered: None 


F15_ PROG_ TERM (AH = 82H) 


Terminate Program. This is a hook for multitasking systems. Currently the function just returns. 


On Entry: AH = F15__PROG__TERM (82h) ™“ 
BX = Device Identifier. 
CX = Process Identifier. 


On Exit: No register modified. 


Registers Altered: None 


F15_ WAIT_EVENT (AH = 83H) 
Allows a process to wait for at least “’x’’ microseconds before it continues. The process is notified 
that the requested amount of time has elapsed when the high bit at ES:BX is set to "1". If 
another process |s already using this function, driver returns with the carry set. If the return 
status is successful (carry flag is clear) the process should poll the byte at ES:BX until the high bit 
is set. 
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On Entry: AH = F15__WAIT__EVENT (83H) 


AL Subfunction: 
O = Set the timer with the data passed in ES, BX, CX and DX registers. 
1 = Cancel the current timer. 
ES:BX = The byte at this address will have its high bit set as soon as possible after the 


é.o@l 


x" microseconds. 
CX,DX = Minimum number, ‘’x’’, of microseconds to wait before setting the high bit of 
the address above. CX is the most significant word. 


On Exit: Carry = 1 If there was another process already waiting. 
O If the calling process will be notified after the time out. 


Registers Altered: AX 


F15_ JOYSTICK (AH = 84H) 
Read data from the joystick port. 


On Entry: AH = F15__JOYSTICK (84H) 
DX = Subfunctions 

O = Read the switch settings. 
1 = Read resistive inputs. 


On Exit: Carry Flag = O If no errors 
1 If invalid DX or no adapter present. 


lf DX was 0, AL bits 7..4 contain switch positions. 


If DX was 1, AX = X position of joystick 1 
BX = Y position of joystick 1 
CX = X position of joystick 2 
DX = Y position of joystick 2 


Registers Altered: AX, BX, CX, DX 


Programming Example: To read all the data from the joystick adapter (switches and both 
joysticks). 


MOV ~~ AH, FI5_JOYSTICK — ; Function 84H 


MOV Dx, 00 , Read the switch settings first 
INT INT__SYSTEM , Int 15H 
IC HANDLE__ERRORS 


System Drivers 275 


MOV = SWITCH__STATE, AL ; Save the state of the switches 


; Bits 7..4 in AL. 
MOV AH, F15_JOYSTICK _ ; Call it again for joystick info 
MOV DX, 07 
INT INT__SYSTEM 
IC HANDLE__ERRORS ~ 
MOV  STICK1_X, AX ; Save x and y position for both 
MOV STICK1__Y, BX ; Joysticks. 


MOV STICK2__X, CX 
MOV  STICK2__Y, DX 


; Continues normally here 
HANDLE__ERRORS: 


, Error handler here 


F15_ SYS. REQ (AH = 85H) 


This subfunction gets called by the keyboard interrupt handler (INT 9H) whenever the user 
presses the <Sys req> key. Currently the routine just returns but an application can trap this i 
function to detect when the user presses this key. 


On Entry: AH 
AL 


F15__SYS__REQ (85H) 
OO, If user pressed the <Sys req> key down (make). 
O1, If user let go of the <Sys req> key (break). 


On Exit: | No values returned. 
Registers Altered: None. 


Example: Link into the current <Sys req> handler so that it prints ‘’HELLO’’ everytime the 
< Sys req> key Is hit. 


INITIALIZATION__CODE: 


MOV AH, 35H , Get the old INT 15H 
MOV AL, INT__SYSTEM , Get CS:/P of INT 15H a 
INT 21H ; This MSDOS Int does the work , 


MOV OLD__SEG, ES 

MOV OLD__OFFSET, BX 

MOV AH,25H ; Replace old INT 15H with 
MOV AL, INT__SYSTEM ; our routine 
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PUSH CS 
POP DS 
MOV DX, offset OUR_JINT15 
INT 21H ; This MSDOS Int does the work 
= 
OUR_INT15: 
CMP AH, F15__SYS__REQ ; See if it is function 85H? 
INE DO__OLD__INT 
PUSHA 
PUSH ES 
MOV AX, F10__WRS__O7 ; Yes, call video “write string” 
MOV BL, O7 , function 1301H to write the 
MOV CX, 05 ; string “HELLO” 
MOV BH, 00 ; page O 
MOV DX, 00 ; row O, column O 
PUSH CS 
POP ES 
MOV BP, Offset HELLO__STR 
INT INT__VIDEO ; Video function interrupt 10H 
= POP ES 
POPA 
IRET 
DO__OLD__INT: 
PUSH OLD__OFFSET ; No, just go to regular routine. 
PUSH OLD__SEG 
RET 
HELLO__STR DB “HELLO” 
F15_ WAIT (AH = 86H) 
Calling this function waits the specified number of microseconds (CX,DX) before returning to the 
caller. 
On Entry: AH = F15__WAIT (86H) 
CX,DX = Number of microseconds to wait. CX is the most significant word. 
e On Exit: | Carry = 1, Some other process already waiting. So could not wait. 


Carry = 0, Waited the amount of microseconds specified in the CX,DX register pair. 


Registers Altered: None. 
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Example: Wait 10 seconds in a procedure. 


MOV AH, F15__WAIT 

MOV CX, O 

MOV DX, 10000 

INT INT__SYSTEM 

IC HANDLE__ERRORS 
HANDLE__ERRORS: 


F15_ BLOCK. MOVE (AH = 87H) 


, 86H function 

, 10 * 1000 microseconds = 
, 10 seconds 

, INT 15H 


; At least 10 seconds have elapsed 


; Do what's appropriate here. 


Moves a block of memory from one location to another anywhere in the 16 megabyte 
addressing space of the 80286 processor. The number of words to move is passed in CX and the 
source and destination tables pointers are passed in a Global Descriptor Table (GDT) pointed to 
by ES:SI. The following data structure describes a sample GDT: 


ADDRESS_ DATA STRUC 
RESERVED__GDT DB 


CALLERS__GDT DB 
SOURCE__GDT DB 
DEST__GDT DB 
BIOS__GDT DB 
STACK__GDT DB 


ADDRESS__DATA = ENDS 


8 DUP (?) 
8 DUP (?) 
8 DUP (?) 
8 DUP (?) 
8 DUP (?) 
8 DUP (?) 


; Descriptor used during move 
; Caller’s GDT’s during move 

, GDT describing source 

; GDT describing destination 

; GDT of the BIOS routines 

; Stack’s GDT. 


The eight byte descriptor for source or destination has the following format: 


SAMPLE__GDT STRUC 
SEG__LIMIT DW 
LOW__WORD DW 
HIGH__BYTE DB 
~ ACCESS__RIGHT DB 
RESERVED__WORD DW 
SAMPLE__GDT ENDS 
On Entry: AH = 
ES:S] = 
CX = 
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; Segment Limit 

; Low word of 24 bit address 
; High byte of 24 bit address 
; Segment access rights 


; should always be 93H 
? __; Reserved. 


F15__ BLOCK__MOVE (87H) 
Pointer to descriptor tables. 
Number of words to move. 


On Exit! AH = Return Status: 
0, If successful. 
1, If RAM parity error. 
2, If exception interrupt error. 
3, If gate address line 20 failed. 


Carry Flag = 1, If failure. 
Zero Flag = 1, If successful. 


Registers Altered: AX 


Example: Move the 16KB video buffer to the procedure’s buffer. 


MOV Sl offset DEST , Load table with 24 bit 
; destination address: 

MOV BX, seg BUFFER ; Isolate high nibble of segment 
AND BX, OFOOOH 
SHR BX, 12 
MOV AX, seg BUFFER ; Isolate rest of segment 
SHL AX, 4 
ADD AX, offset BUFFER and form 24 bit address 
INC SKIP__INC 
INC BX 

SKIP__INC: 


MOV BYTE PTR HIGH__BYTE[SI], BL 
MOV WORD PTR LOW__WORDISI], AX 


LES SL ACTUAL__TABLE 

MOV CX, 8192 ; Number of words to move 
MOV AH, F15__MOVE__BLOCK ; Function 87H. 

INT INT__SYSTEM Sint 15H 

IC HANDLE__ERRORS 

INE HANDLE__ERRORS 


; Continue if everything OKAY 

HANDLE__ERRORS: 

; Do Error processing here 
; Actual Table of pointers passed to the routines. They use the 
; Global descriptor structure described above. 
ACTUAL__TABLE: 
RESERVED SAMPLE__GDT <0,0,0,0,0> 
CALLERS SAMPLE__GDT <0,0,0,0,0> 
SOURCE SAMPLE__GDT < 16384,8000H,OBH,93H,0> 
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DEST SAMPLE__GDT < 16384,0,0,.93H,O> _ ; The high byte 
: and low word 


; will be loaded 
: in the code 
BIOS SAMPLE__GDT <0,0,0,0,0> 
STACK SAMPLE__GDT <0,0,0,0,0> 
BUFFER DB 16384 DUP (?) ; Actual destination buffer 


F15_ GET_XMEM_ SIZE (AH = 88H) 
Determine how much RAM there is above the first one megabyte of memory. 


On Entry: AH = F15__GET_XMEM__SIZE (88H) 


On Exit: . AX = Total number of 1KB blocks above one megabyte. 


Registers Altered: AX. 


F15_ ENTER_PROT (AH = 89H) 


Allows a routine to enter protected mode. When the BIOS function has executed, the processor 
will be in protected mode and the routine specified will be called. The calling program must 
create a set of descriptor tables as follows: 


Dummy Descriptor Table: Initialize to zero. 

Global Descriptor Table: Load program dependant values. 
Interrupt Descriptor Table: Load program dependant values. 
Data segment Descriptor: Load program dependant values. 
Extra segment Descriptor: Load program dependant values. 
Stack segment Descriptor: Load program dependant values. 
Code segment Descriptor: Load program dependant values. 


BIOS Descriptor Table: Initialize to zero. 
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When calling this function, the user should be aware that: 1) the BIOS functions are not 
available, 2) the interrupt tables must be moved to avoid conflict with the 80286 interrupt 
vectors, 3) the user loaded descriptor tables must not overlap with the BIOS’s descriptor tables 
and 4) because of the system’s second (HP) 8259 slave controller, both the master 8259 and the 
HP slave must be reprogrammed by the user on entry to protected mode. 


Upon return from protected mode the system BIOS will return control to the return point 
specified at 40H:67H. The user should recover the stack and continue. 


There are a few points of caution that should be observed: 


1. Any code which is expected to run mixed mode, that is both protected mode and real 
mode, must not make any far references, including far calls. 


2. Also, any return addresses put on the stack must have been generated in the same mode in 
which the return code executes, or else they must be near returns. 


3. The system address line A20 must be forced to 0 when the system is operating in real 
mode. This task is performed by the 8041 controller. When the system enters protected 
mode, A20 must be released, and when it enters real mode it must be forced to 0 again. It 
is the program's responsibility to issue the appropriate command to the 8041 controller 
before changing modes (see Section 5). 


On Entry: AH = F15__ENTER__PROT (89H) 


BH = Offset into interrupt table where interrupts coming from the Master 8259 will 
go (Interrupt level 1). 
BL = Offset into interrupt table where interrupts coming from the industry standard 
(STD) slave 8259 will go (Interrupt level 2). 
ES:S|_ = Pointer to a set of descriptor tables. The following descriptors must be passed 


by the calling routine: Dummy Descriptor (DUMMY), Global Descriptor Table 
(GDT), Interrupt Descriptor Table (IDT), Data Segment Descriptor Table (DS), 
Extra Segment Descriptor Table (ES), Stack Segment Descriptor Table (SS), 
Code Segment Descriptor Table (CS) and BIOS Descriptor Table (BIOS). 

On Exit: AH = O, If successfully entered Protected Mode. 


Registers Altered: All. 


Example: To enter protected mode and start executing the routine PROTECTED. 


: Load up descriptor tables with appropriate values. See the 
; IAPX 286 Programmer's Reference Manual for details. 


/ 
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: Load registers for calling INT 15H function. 
| MOV AH, F15__ENTER__PROT __; Enter protected mode 
; function 89H. 


; Offset for 8259's must be greater than 32 because 80286 

, uses the first 32 interrupts vectors. 

MOV — BH, 40 , New offset for master 8259. 
MOV BL, 48 , New offset for STD-slave 8259. 
MOV ES, seg GLOBAL__TABLE __ , Table of descriptors. 

MOV _ Sl, offset GLOBAL__TABLE 

INT INT__SYSTEM , Int 15H 


PROTECTED: 


: Code starts executing here after call to INT 15H 
; sets up CS__DT to point to PROTECTED label. 


, The first thing to do in this case is reprogram the master 
, 8259 and the HP-slave (interrupt controller's): 
SLV__M__PORTO EQU = 20H 

SLV__M__PORT1 EQU 21H 

SLV__S71_PORTO EQU /7CH 

SLV__S1__PORT1 EQU = 7DH 


: Program the master 8259: 


/ 


MOV AL,11H , Edge triggered cascade mode 
OUT SLV__M__PORTO,AL 

JMP $+2 

MOV AL,40 , Interrupt TYPE 40. 

OUT SLV__M__PORT1,AL 

JMP $+2 

MOV ~ AL,O6H , Slaves mask, at interrupt levels 
OUT SLV__M__PORT1,AL , land 2. 

JMP $+2 

MOV AL,OT , 8259 in “8086” mode. 

OUT SLV__M__PORT1,AL 

JMP $+2 

MOV ~~ AL,OFFH ; Disable all interrupts. 
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OUT SLV_.M__PORT1,AL 
JMP $+2 
; PROGRAM HP-SLAVE’S 8259: 
MOV AL,11H ; Edge triggered cascade mode 
OUT SLV__S1__PORTO,AL 
JMP $+2 
MOV AL,56 ; Interrupt type 56. 
OUT SLV__S1__PORTT,AL 
JMP $+2 
MOV AL,O1 ; Slave ID 
OUT SLV__S1__PORTT1,AL 
JMP $+2 
MOV AL,O1 ; “8086"' Mode 
OUT SLV__S1__PORTT,AL 
JMP $+2 
MOV ~~ AL,OFFH ; Disable all interrupts 
OUT SLV__S1__PORT1,AL 
JMP $+2 
MOV  AL,68H , Enable special mask mode. 
OUT SLV__S1__PORTO,AL 
JMP 


$+2 


; Continue with protected mode here. 


; Descriptor tables needed for this function call. The entries 

; marked by ‘F’ must be filled in by the user. Those marked with 

, ‘0’ are filled by INT 15H. For a definition of the SAMPLE__GDT 

; structure see the F15__BLOCK__MOVE example. For information as 
, to how to fill this table see the iAPX 80286 Programmer's 

, Reference Manual. 


GLOBAL__ TABLE: 


RESERVED 
GLBL__DT 
IDT_DT 
DS__DT 
ES__DT 
SS__DT 
CS_ DT 
BIOS__DT 


SAMPLE__GDT 
SAMPLE__GDT 
SAMPLE__GDT 
SAMPLE__GDT 
SAMPLE__GDT 
SAMPLE__GDT 
SAMPLE__GDT 
SAMPLE__GDT 


<0,0,0,0,0> 
<FFF.F,F> 
<FFF,F,F> 
<FFF,F,F> 
<F,FFF,F> 
<FFF,F,F> 
<FFF,F.F> 
<0,0,0,0,0> 


System Drivers 283 


Fi5_ DEV_BUSY (AH = 90H) 


Device busy function. This is a ‘hook’ for multitasking systems. Currently the function Just clears 
the Carry flag and returns. 


On Entry: AH 
AL 


F15__ DEV__BUSY (90H) 
Device Type: 
O thru 7FH = Device can not be shared. The operating system handling this 
‘hook’ must serialize access to this device. 
80H thru OBFH = Device can be shared among multiple processes. The operating 
system handling this ““hook’’ must use the ES:BX registers to 
distinguish between calls. 

OCOH thru OFFH = Devices of this type must wait for a fixed amount of time. This 
amount of time is device dependant. Control should be returned 
to the device after the fixed amount time. 

List of Device Types: 

OOH = Disc, time out required 

O1H = Diskette, time out required 

O2H = Keyboard, no time out required 

80H = Network, no time out required 
OFDH = Start diskette motor, time out required 
OFFH = Printer, time out required. 


On Exit: No values returned. 


Registers Altered: None. 


F15_ INT_COMPLETE (AH = 91H) 


Signals interrupt completed. This is a ““hook’’ for multitasking systems. Currently the function 
does an IRET. 


On Entry: AH 
AL 


F15__INT__COMPLETE (91H) 
Device Type, see list of previous function. 


On Exit: | No registers used. 


Registers Altered: None. 
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9.6 Time And Date Driver (INT 1AH) 


Table 9.2 describes functions provided by the BIOS to manage the CMOS clock and the software 
clock. 


Table 9.2 


Time and Date Driver Function Code Summary 


INT Function Function 

Hex Equate Value Definition 

1AH_ INT__CLOCK Time and date 
FiIA__RD__CLK__ CNT OOH Read current clock count 
FIA __SET_CLK._CNT O1H Set current clock count 
F1A__GET__RTC O2H Read real-time clock 
FIA__SET__RTC O3H Set real-time clock 
F1A__GET__DATE O4H Read date from real-time clock 
F1A__SET__DATE OSH Set date in real-time clock 
FIA__SET__ALARM O6H Set alarm 
F1A__RESET__ALARM O7H Reset alarm 


Time and Date Driver Function Definitions 


F1A__RD__CLK_CNT (AH = OOH) 


Reads the current setting of the software clock. There are 18.2 counts per second. 


On Entry: AH = F1IA__RD__CLK__CNT (OOH) 


On Exit: AL = Zero if the timer has not overflowed (not passed 24 hours since the last read). 
Nonzero if time has overflowed. 
CX = High word of the count. (There are 18.2 counts per second). 
DX = Low word of count. 


Registers Altered: AX, CX, DX 
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FIA_SET_CLK_CNT (AH = 01H) 


Sets the count in the software clock. And resets the 24 hour overflow bit. 


On Entry: AH = F1A__SET__CLK__CNT (01H) 
CX = High word of Count. 7 
DX = Low word of Count. 


On Exit: | No values returned. 


Registers Altered: None 


F1A_GET_RTC (AH = 02H) 


Gets the time from the real-time clock. 


On Entry: AH = F1A__GET_RTC (02H) 
On Exit: CH = Hours in BCD. 

CL = Minutes in BCD. 

DH = Seconds in BCD. 


Carry flag = 1 if real-time clock is not operating. 


Registers Altered: AH, CX, DH 


F1A_SET_RTC (AH = 03H) 


Sets the time of the real-time clock. 


On Entry: AH = F1A__SET__RTC (03H) 
CH = Hours in BCD. 
CL = Minutes in BCD. 
DH = Seconds in BCD. 
DL = 1 if daylight savings time option. 


O otherwise. 
On Exit: | No values returned. 


Registers Altered: AH. 
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FIA_GET_DATE (AH = 04H) 


Gets the date from the real-time clock. 


On Entry: AH = F1A__GET__DATE (04H) 
On Exit: CH = 19 if 20th century or 
20 if 21st century. 
CL = Year in BCD. 
DH = Month in BCD. 
DL = Day in BCD. 


Carry flag set if the real-time clock not operating. 


Register Altered: AH, CX, DX. 


FIA_SET_ DATE (AH = 05H) 


Sets the date of the real-time clock. 


On Entry: AH = F1A__SET__DATE (05H) 
CH = 19 if 20th century or 
20 if 21st century. 
CL = Year in BCD. 
DH = Month in BCD. 
DL = Day in BCD. 


On Exit: No values returned. 


Registers Altered: AH. 


FIA_SET_ALARM (AH = 06H) 


Sets the alarm to generate an INT 4AH when the specified amount of time has elapsed. The user 
must place an appropriate interrupt handling routine in the INT 4AH vector. 


On Entry: AH = F1A__SET__ALARM (06H) 
CH = Hours in BCD. 
CL = Minutes in BCD. 
DH = Seconds In BCD. 


On Exit: Carry flag = 1 if the real-time clock is not operating or the alarm is already set. 


Registers Altered: AH. 
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F1A_RESET_ALARM (AH = 07H) 

Clears the current alarm if any was set. 

On Entry: AH = F1A__RESET__ALARM (07H) 
On Exit: | No values returned. 


Registers Altered: AH. 


9.7 V__SCOPY Driver (BP = 0000H) 


This driver does an IRET for all function calls. 


9.8 V__DOLITTLE Driver (BP = 0006H) 


This driver does an IRET for all function calls. 


9.9 V__PNULL Driver (BP = 000CH) 


This driver loads AH with RS__SUCCESSFUL and does an IRET for all function calls. 


9.10 V__SYSTEM Driver (BP = 0012H) 


Table 9.3 summarizes the V__SYSTEM Functions. A more detailed description follows the table. 
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Table 9.3 
V__SYSTEM Driver Function Code Summary 


Vector Func. Function 
Address Value Equate Definition 


V__SYSTEM 


System Management Functions 


0012H OO F__ISR Interrupt service routine 
(unsupported) 

O0012H O02 F__ SYSTEM Standard Driver Functions 

0012H 02/00 SF__INIT System initialization 

0012H O04 F__INS__BASEHPVT Returns HP__VECTOR__TABLE 


segment 


F__INS_ XCHGFIX Exchanges fixed table entries 
O012H O08 F_INS__ XCHGRSVD Sets next “‘reserved”’ entry in table 
0012H OA F__INS__ XCHGFREE Sets next ‘free’ entry in table 
O012H OC F__INS__FIXOWNDS Install fixed vector, user supplies DS 
0012H OE F__INS__FIXGETDS Install fixed vector, system supplies 


DS 
Install fixed vector, DS set to global 


F__INS__FIXGLBDS 


data area 

QO012H 12 F__INS__FREEOWNDS Install next free vector, user supplies 
DS 

OO12H 14 F__INS__FREEGETDS Install next free vector, system 
supplies DS 

O012H 16 F__INS__FREEGLBDS Install next free vector, DS set to 


global data area 


0012H 18 F__INS__ FIND Search for matching device header 


OO12H 1€E F__RAM__GET Get EX-BIOS memory pool address 
and size 

0012H 20 F__RAM__RET Set memory pool address and size 

O012H 22 F__CMOS__GET Read and verify CMOS memory 

O0012H 24 F__CMOS__RET Write to CMOS memory 

O012H 2A F__ YIELD Just returns 

QO012H e2C Reserved 

OO12H 2E Reserved 

O012H 30 F__SND__CLICK__ENABLE Enable keyclick 

O0012H 32 F__SND__CLICK DISABLE —_ Disable keyclick (Default) 

OO12H 34 F__SND__CLICK Execute keyclick if enabled 
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Vector Func. Function 
Address Value lEquate Definition 


F__SND__BEEP__ENABLE Enables beep 
F__SND__BEEP__DISABLE Disables beep 
F__SND__BEEP Beeps If enabled 
F__SND__SET___BEEP Sets beep frequency 


F__SND__TONE Produce tone, user supplied duration 
and frequency 


F__STR__GET__FREE__INDEX Return next free string index 
F__STR__DEL__BUCKET Delete bucket string list 

F__ STR__PUT__BUCKET Add bucket to current string list 
F__STR__GET__STRING Search the list for index, return string 
F_ STR__GET__INDEX Search list for a string, return index 


Registers Altered: AH, DS, BP, ES 


Example: Get the Base address of the HP_VECTOR__TABLE. 


MOV — BP, V_SYSTEM , HP vector (12H). 
MOV AH, F__INS__BASEHPVT ; function 04H 

PUSH =DS ; EX-BIOS destroys DS 
INT HP__ENTRY ; Int 6FH for EX-BIOS 
MOV AxX,DS 

POP DS ; Restore DS 

MOV  GLOBAL__DATA__AREA, AX 

MOV AX,ES 


MOV VECTOR__TABLE__SEGMENT, AX 
The value returned in ES is the segment address of the HP__VECTOR__TABLE and the value 
returned in the DS register is the segment address of the EX-BIOS global data area. 


V__SYSTEM Driver Function Definitions 


F_ISR (AH = 00H) 


Logical interrupt service routine. Currently, it loads AH with RS__UNSUPPORTED and does an 
IRET. 


On Entry: BP 
AH 


V__SYSTEM (12H) 
F__ISR (OOH) 
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On Exit: AH = RS__UNSUPPORTED (02H) 


Registers Altered: AH, BP, DS 


SF_INIT (AX = 0200H) 


System functions routines. The only function supported is SF__INIT (OOH). The rest of the routines 
return with a status of RS__UNSUPPORTED In AH. 


The SF__INIT routine sets up DS and initializes all the variables in the EX-BIOS global data area. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__SYSTEM (02H) 
AL = SF__INIT (OOH) 
On Exit: AH = Return Status Code 
BX = DS of EX-BIOS global data area 


Registers Altered: AH, BX, DS, BP 


F_INS__BASEHPVT (04H) 


Reports the segment where the HP__VECTOR_TABLE is located. This function can only be called 
after the V__SYSTEM driver has been initialized. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__INS__BASEHPVT (04H) 

On Exit: AH = Return Status Code 
ES = Segment address of HP_VECTOR_TABLE. 
DS = Segment of EX-BIOS global data area 


F__INS_XCHGFIX (AH = 06H) 


Exchanges the values in the registers for a particular entry in the HP__VECTOR__TABLE. This 
function can be used to replace an existing vector at a fixed location without initialization. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__INS__XCHGFIX (06H) 
BX = Vector address 
DX = DS to be exchanged 
ES:DI_ = CS:IP to be exchanged 
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On Exit: AH = Return Status Code 
O = RS__ SUCCESSFUL 
DX = DS from table 
ES:DI = CS:IP from table 


Registers Altered: AH, BP, DS, ES, Di, DX 


Example: Replace the EX-BIOS V__SVIDEO vector (54H). 


MOV BP, V_SYSTEM , HP vector 12H. 

MOV AH, F__INS__XCHGFIX , Function O6H 

MOV BX, V_SVIDEO , HP vector 54H 

MOV DI CS , Get CS, IP and DS of new 
MOV FS, DI ; video routines. 

MOV ODI, offset NEW__VIDEO__ROUTINE 

MOV Dx, DS 

PUSH DS ; EX-BIOS Destroys DS 
INT HP__ENTRY , Int 6FH for EX-BIOS — 
POP DS 

MOV  OLD__CS, ES ; Save old CS, IP and DS 
MOV OLD_IP, DI ; Just in case we need to 
MOV  OLD__DS, DX ; put them back 


F_INS_ XCHGRSVD (AH = 08H) 


Exchanges the values in the registers for the next reserved entry in the HP__VECTOR__TABLE. If a 
reserved vector is not available the function returns the RS__NO__VECTOR error code. 


On Entry: BP = V__SYSTEM (12H) 

= F_INS__XCHGRSVD (08H) 
DX = DS to be exchanged 

= CS:IP to be exchanged 


On Exit: AH = Return Status Code 
0 = RS__ SUCCESSFUL 
OF6H = RS_NO__VECTOR 


BX = Vector address 
DX = DS from table 
ES:DI = CS:IP to be exchanged 


Registers Altered: AH, BP, DS, BX, ES, DI, DX 
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F_INS_XCHGFREE (AH = OAH) 


Exchanges the values in the registers for the next free entry in the HP_.VECTOR__TABLE. If a free 
vector Is not available, the function returns the RS__NO__VECTOR error code. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__INS__XCHGFREE (OAH) 
DX = DS to be exchanged 
ES:DI = CS:IP to be exchanged 
On Exit! AH = Return Status Code 
0 = RS__ SUCCESSFUL 
OF6H = RS_NO__VECTOR 
BX = Vector address 
DX = DS from table 
ES:DI = CS:IP to be exchanged 


Registers Altered: AH, BP, DS, BX, ES, DI, DX 


F_INS_ FIXOWNDS (AH = OCH) 


Installs a given vector entry in the HP__VECTOR__TABLE and calls it with an SF__INIT function. 
Upon returning from initialization, the routine returns its data segment in the BX register. 
Warning 


If the SF__INIT function returns with an error code of RS__FAIL (OFEH) the power-on 
self test sequence will be executed. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__INS__FIXOWNDS (OCH) 
BX = Vector address to be installed 
ES:DI = CS:IP of the device 


On Exit: AH = Return Status Code 
O = RS__SUCCESSFUL 


Registers Altered: AH, BP, DS 
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F_INS_ FIXGETDS (AH = OEH) 


Installs a given vector entry in the HP_.VECTOR_TABLE and calls it with an SF__INIT function. 
This function should be used if the driver needs EX-BIOS RAM for its data segment. 
F__INS__FIXGETDS calls the routine to initialize with the “‘last used DS” in the BX register. The 
routine’s initialization code decrements the “last used DS” value and returns to 
F__INS__FIXGETDS with this new value. 


Warning 


If the SF__INIT function returns with an error code of RS__FAIL (OFEH) the power-on 
self test sequence will be executed. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__INS__FIXGETDS (OEH) 
BX = Vector address to be installed 
ES:DI = CS:IP of the routine 
On Exit, AH = Return Status Code 


O = RS__SUCCESSFUL 


Registers Altered: AH, BP, DS 


F_INS__FIXGLBDS (AH = 10H) 


Installs a given vector entry in the HP__VECTOR_TABLE and calls it with an SF__INIT function. 
When F__INS__FIXGLBDS calls the initialization routine it passes the data segment of the EX-BIOS 
global data area in the BX register. 


Warning 


If the SF_INIT function returns with an error code of RS__FAIL (OFEH) the power-on 
self test sequence will be executed. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__INS__FIXGLBDS (10H) 
BX = Vector address to be installed 
ES:DI = CS:IP of the routine 


On Exit: AH = Return Status Code 
O = RS__ SUCCESSFUL 


Registers Altered: AH, BP, DS 
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F_INS_FREEOWNDS (AH = 12H) 


Installs a vector in the next free entry of the HP__.VECTOR__TABLE and calls it with an SF__INIT 
function. Upon returning from initialization, the routine returns its DS in the BX register. 
Warning 


If the SF__INIT function returns with an error code of RS__FAIL (OFEH) the power-on 
self test sequence will be executed. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__INS__FREEOWNDS (12H) 
BX = Vector address to be installed 
ES:DI = CS:IP of the device 
On Exit: AH = Return Status Code 


O = RS__SUCCESSFUL 


Registers Altered: AH, BP, DS 


F_INS_ FREEGETDS (AH = 14H) 


Installs a vector in the next free entry of the HP__VECTOR__TABLE and calls it with an SF__INIT 
function. This function is used if the driver needs EX-BIOS RAM for its data segment. 
F__INS__FREEGETDS calls the routine to initialize with the ‘‘last used DS” in the BX register. The 
routine’s initialization code decrements the ‘‘last used DS”’ value and returns it to 
F__INS__FREEGETDS. 


Warning 


If the SF__INIT function returns with an error code of RS__FAIL (OFEH) the power-on 
self test sequence will be executed. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__INS__FREEGETDS (14H) 
ES:DI = CS:IP of the routine 


On Exit: AH = Return Status Code 
O = RS__SUCCESSFUL 


Registers Altered: AH, BP, DS 


Example: Install the ACME__INT vector in the next free vector and allocate two paragraphs of 
data when its initialization routine gets called. 
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MOV BP, V_SYSTEM , HP vector 12H for EX-BIOS. 


MOV AH, F_INS__FREEGETDS ; Function 14H 

MOV DI, CS ; Get CS, IP of ACME__JNT routines 
MOV ES, DI 

MOV DI, offset ACME__INT 

PUSH DS ; EX-BIOS Destroys DS 

INT HP__ENTRY , Int 6FH for EX-BIOS 

POP DS 

MOV VECTOR__NUMBER, BX ; Save the vector number 


; routines are installed. 


*, ACME__INT routine handles initialization and allocates 2 
; paragraphs from EX-BIOS RAM for its data segment. 


ACME__INT: 
CMP AH, F_SYSTEM ; Decode F_SYSTEM subfunction 
JNE NOT__SUPPORTED ; SF_JNIT. 
CMP AL, SF_JINIT 
JE ACME__JINIT 
NOT__SUPPORTED: ; Any unknown functions should 
MOV AH, RS__UNSUPPORTED , return with RS__UNSUPPORTED 
IRET LIN AH. 
ACME__INIT: 
SUB BX, 2 ; Decrement the “last used DS” 
; passed to us. This allocates 2 
; paragraphs and makes our data 
; segment the “last used DS". Make 
; sure to pass this new BX back to 
, F_INS__FREEGETDS code. 
MOV DS, BX ; Now we can initialize the data in 
; our segment. 
ASSUME  DS:NOTHING 
MOV ACME__ATTR, 55AAH * Put data into Attribute word 


MOV ACME__NAME__INDEX, 55AAH _ ; Put a dummy index for now. 
| ; Initialize rest of data segment here. 
MOV AH, RS__ SUCCESSFUL ; Always return this status if 


; successful initialization. 
IRET 
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; Sample segment for this routine 


ACME__SEG struc 

ACME__ATTR dw 0 , Attribute word of ACME’s data 
; segment. 

ACME__NAME__JNDEX dw 0 ; Index name of ACME routine. 

ACME__REST db 28 dup (?) _ ; rest of data segment 

ACME__SEG ends 


F_INS_ FREEGLBDS (AH = 16H) 


Installs a vector in the next free entry of the HP_VECTOR__TABLE and calls it with an SF__INIT 
function. When F__INS__FREEGLBDS calls the initialization routine it passes the data segment of 
the EX-BIOS global data area in the BX register. 


Warning 


If the SF__INIT function returns with an error code of RS__FAIL (OFEH) the power-on 
self test sequence will be executed. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__INS__FREEGLBDS (16H) 
ES:DI = CS:IP of the routine 


On Exit: AH = Return Status Code 
O = RS__ SUCCESSFUL 


Registers Altered: AH, BP, DS 


F_INS_ FIND (AH = 18H) 


This function is used to search the HP__VECTOR__TABLE for drivers that have equal or similar 
values in a specified field of their data segment. Parameters passed to the function specify the 
location of the 16-bit field, the bits within the field to be compared (and__mask) and the pattern 
of bits the field is to be compared with. Given a starting vector address, the function searches 
the vector table for the next driver that matches the conditions specified and returns its vector 
address in Sl. 
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On Entry: BP = V__SYSTEM (12h) 
AH = F__INS__FIND (18H) 
AL = 0 then respond on equality to pattern 
(field) AND. (and__mask)) = pattern 
2 then respond on non__equal 
(field) AND. (and__mask)) < > pattern 
BX = and__mask 
DX = pattern 
S| = vector address to start the search from. 
D| = field to be used in the function, this is the offset into an HP header. 
On Exit: AH = Return status 
= RS_ SUCCESSFUL 
OFEH = RS__FAIL—No match found 


S| = Vector address of the first entry that matched. 
Registers Altered: AH, BP, DS, SI 


Example: Find a vector that has the value X5AXH (’’X"’ means allow these digits to take any 
value) in its attribute header (the first word of the driver's data segment) — 


MOV 
MOV 
MOV 


MOV 
MOV 


MOV 
MOV 


PUSH 
INT 
POP 
CMP 
INE 
VECTOR__FOUND: 
MOV 


BP, V_SYSTEM 
AH, F__INS__FIND 
AL, O 


DI, O 
DX, OSAOH 


BX, OFFOH 
SI, O 


DS 

HP__ENTRY 

DS 

AH, RS__SUCCESSFUL 
VECTOR__NOT__FOUND 


SAVED__VECTOR, SI 


VECTOR__NOT__FOUND: 
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, HP vector 12H 

; Function 18H 

, Return RS__SUCCESSFUL when the 
; value Is equal 

, Look in the first word of driver's 

; data segment 

, Look for value ‘5A’ in the middle 
; of the word. 

; Mask off the don’t care parts. 

; Start looking from the first vector 
; position. 

, EX-BIOS destroys DS 

; Int 6FH for EX-BIOS 


; See if it found a match ? 


; Yes 


; No 


F_RAM_GET (AH = 1EH) 


This function gets the segment pointers of the EX-BIOS free RAM area. Two pointers are 
returned by this function call, the ‘last used DS" pointer marks the first paragraph of EX-BIOS 
RAM that is free for use. The “max DS” pointer marks the lowest value that “‘last used DS” can 
have. Figure 9.1 shows how the EX-BIOS memory is organized. 


See the F_RAM__RET memory function. 


On Entry: BP = V__SYSTEM (12h) 
AH = F__RAM__GET (1Eh) 
On Exit: AH = RS_ SUCCESSFUL 
BX = ‘‘last used DS” 
DX = “max DS” 


Registers Altered: AH, BP, DS, BX, DX 


F_RAM__RET (AH = 20H) 


Sets the “last used DS" and ‘’max DS" EX-BIOS pointers to the values passed in the BX and DX 
registers. This allows the calling routine to reserve a piece of the EX-BIOS memory. 
Caution 


The F_INS__FIXGETDS and F__INS__FREEGETDS functions described above also mod- 
ify these values. Use caution when allocating memory with both methods. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__RAM__GET (20h) 
BX = “last used DS” 
DX = “max DS” 

On Exit: AH = RS__ SUCCESSFUL 


Registers Altered: AH, BP, DS 


Example: The following code allocates five paragraphs (80 bytes) of EX-BIOS memory. 


Get the memory pointers first. 


MOV BP, V_SYSTEM / HP vector 12H. 
MOV AH, F_RAM__GET ; function 1EH 
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PUSH DS ; EX-BIOS Destroys DS 
INT —HP__LENTRY ; Int 6FH for EX-BIOS 
POP DS 


; Check to see if there is enough memory to allocate 5 paragraphs. 


/ 


SUB BX, OOO5H , Create a new “last used DS”’ by 
; moving pointer towards ‘max DS”. 
CMP BX, DX SIs “last used DS” > = “max DS”? 
JL NO__MEMORY__LEFT 
ENOUGH__MEMORY__LEFT: , Yes: Allocate 5 paragraphs. 
MOV BP, V__SYSTEM , HP vector 12H 
MOV AH, F_RAM__RET ; function 20H 
PUSH DS , EX-BIOS Destroys DS 
INT | HP__ENTRY , Int 6FH for EX-BIOS 
POP DS 
MOV MEMORY__SEG, BX ; Save this new memory pointer for 
; later use 
; Continue 
NO__MEMORY__LEFT: ; No: 


Typical thing to do here is to allocate more memory for the 
, the EX-BIOS RAM and reboot system. 


F_CMOS_GET (AH = 22H) 


Read a byte from CMOS. It verifies the checksum on the industry standard CMOS area and 
returns RS__FAIL if the checksum Is invalid. 


On Entry: BP = V__SYSTEM (12H) 
AH = F_CMOS__GET (22H) 
BL = address of CMOS byte to read 
On Exit: AH = Return Status Code 
AL = byte of data from CMOS 


Registers Altered: AX, BP, DS. 
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F_CMOS_ RET (AH = 24H) 


Write a byte to CMOS. Calculate a new checksum for both the industry standard CMOS area and 


the HP CMOS area. 


On Entry: BP = V__SYSTEM (12H) 

AH = F_CMOS_ RET (24H) 

AL = byte of data to be written to CMOS 

BL = address of byte to be written to CMOS 
On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS. 


Example: Make the monochrome display the primary video adapter by setting this information in 


the equipment byte of CMOS memory. 


; Read the equipment byte. 
MOV BP, V_SYSTEM , HP vector 12H. 
MOV AH, F_CMOS__GET — ; function 22H 
MOV BL, 14H , Address of the equipment byte 
PUSH DS ; EX-BIOS destroys DS 
INT HP__ENTRY , Int 6FH for EX-BIOS 
POP DS 
CMP AH, RS__FAIL ; See if CMOS ts valid 
JE INVALID__CMOS 


; Isolate the video and set appropiate video bits. 


AND AL, 11001111B 


OR AL, 00110000B ; Select monochrome display 


; Write the equipment byte. 


MOV BP, V__SYSTEM , HP vector 12H 
MOV AH, F_.CMOS__RET _ ; function 24H 

PUSH DS ; EX-BIOS destroys DS 
INT HP__ENTRY , Int 6FH for EX-BIOS 


POP DS 
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INVALID__CMOS: 


F_ YIELD (AH = 2AH) 


Currently loads AH with RS__SUCCESSFUL and does an IRET. This is a “hook” for multitasking 
systems. 


On Entry: BP 
AH 


V__SYSTEM (12H) 
F__ YIELD (2AH) 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 


F_SND__CLICK_ENABLE (AH = 30H) 


Enables the keyclick function and flushes any pending keyclicks. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__SND__CLICK__ENABLE (30H) 
On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS. 


F_SND_ CLICK_DISABLE (AH = 32H) 


Disables the keyclick function, sets the EX-BIOS global data area T_SND__CLICK__DURA byte to 
zero, and flushes any pending keyclicks. 


On Entry: BP 
AH 


V__SYSTEM (12H) 
F__SND__CLICK__DISABLE (32H) 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 
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F_SND_ CLICK (AH = 34H) 
This functions under the following conditions: 


@ If greater than or equal to four clicks are pending then exit. 


@ If less than four clicks are pending then increment the count and exit. 


@ If no keyclicks are pending then execute the keyclick. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__SND__CLICK (34H) 
On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 


F_SND__BEEP_ENABLE (AH = 36H) 
Enables the beep function. 


V__SYSTEM (12H) 
F_.SND__BEEP__ ENABLE (36H) 


On Entry: BP 
AH 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 


F_SND__BEEP__DISABLE (AH = 38H) 
Disables the beep function. 


On Entry: BP 
AH 


V__SYSTEM (12H) 
F__SND__BEEP__DISABLE (38H) 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 
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F_SND_ BEEP (AH = 3AH) 


Makes a sound as defined by the current values of T_SND__BEEP__CYCLE and 
T__SND__BEEP__DURA in the EX-BIOS data area. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__SND__BEEP (3Ah) 
On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 


F_SND__SET__BEEP (AH = 3CH) 


Defines beep frequency and duration. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__SND__SET__BEEP (3CH) 
BX = Frequency 1 to 25000 hz. 
lf (BX) = O then tone off. 
DX = duration of tone in 10 microsecond increments 


On Exit: AH = Return Status Code 
Registers Altered: AH, DS, BP. 


Example: Set Beep frequency to 660 Hz for duration of 1/2 second. 


MOV BP, V_SYSTEM , HP vector 12H 
MOV  AH,F._SND__SET__BEEP _— ; function 3CH 
MOV BX, 660 ; Frequengy in hertz 
MOV DX, 50000 ; 1/2 a second in 10 
; microseconds increments. 
PUSH DS , EX-BIOS destroys DS 
INT HP__ENTRY , Int 6FH for EX-BIOS 
POP DS 


F_SND_TONE (AH = 3EH) 


Generates a tone of the given frequency and duration with an approximate 0.5 percent error. 
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On Entry: BP = V__SYSTEM (12H) 


AH = F__SND__TONE (3EH) 
BX = Frequency 1 to 25000hz 
lf (BX) = O then tone off. 
- DX = Duration of tone in 10 microsecond increments. 
| On Exit: AH = Return Status Code 


Registers Altered: AH, DS, BP 


F_STR__GET__FREE_INDEX (AH = 40H) 


Returns to caller the next string index that does not conflict with the ROM based string indices. 


On Entry: BP = V__SYSTEM (12H) 

AH = F__STR__GET__FREE__INDEX (40H) 
On Exit: AH = RS__ SUCCESSFUL 

BX = Next free index. 


oo Registers Altered: AH, BX, DS, BP 


Example: This example gets the next string index available to the user. 


Mov BP, V__SYSTEM , HP vector 12H 
Mov AH,F__STR__GET__FREE__INDEX ; function 40H 

PUSH DS ; EX-BIOS destroys DS 
INT HP__ENTRY , Int 6FH for EX-BIOS 
POP DS 


MOV FIRST__FREE__INDEX,BX , Save it for later use. 


F_STR_DEL_BUCKET (AH = 42H) 


= Finds a header with the given address and deletes it from the bucket header list. 
On Entry: BP = V__SYSTEM (12H) 
AH = F__STR__DEL_BUCKET (42H) 
DI = offset address of bucket header 
ES = segment address of bucket header 
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On Exit: AH = RS__SUCCESSFUL if header found and deleted 
RS__FAIL if header not found. 


Registers Altered: AH, DS, BP. 


F_STR_PUT_.BUCKET (AH = 44H) 


Takes a header and its corresponding pointers and adds them to the front of the list. 


On Entry: BP = V__SYSTEM (12H) 
AH = F_STR__PUT__BUCKET (44H) 
DI = Offset address of header 
ES = Segment address of header 
On Exit: AH = RS_ SUCCESSFUL 


Registers Altered: AH, BP, DS. 


Example: Adds a set of strings and its associated data structures for the ACME__INT driver. 


: String data structures (see figure 9.2) 


STR__HEADER STRUC 
STR_NXT__HDR DD (?) 
STR__UPPER__BOUND DW (?) 
STR_LOWER__BOUND DW (?) 
STR__LIST__PTR DD (?) 
STR__SEGMENT DW (?) 
STR__HEADER ENDS 


: Now build a bucket (set of strings) for the ACME__INT: 


First list ACME__INT’s strings: 


size__acme__name db |__acme__name - f__acme__name - J 
f__acme__name = $ 

acme__name db ‘Acme Co.’,OH 

|__ acme__name = $ 

size__jtem__1 db |__item__1 - f_jtem__1 - 7 
f__jtem__1 = $ 

item__1 db ‘Hello World’,OH 

|__jtem__1 = $ 
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size__jtem__2 db 
f__jtem__2 = 
item__2 db 
|__ jtem__2 = 


|__ jtem__2 - f__jtem__2 - 1 
$ 

‘Widgets’,OH 

$ 


: Now build table of bucket pointers: 


acme__ptrs label 
dw 
dw 
dw 


near 

offset acme__name 
offset item__1 
offset item__2 


: Now build the bucket header data structure 


acme__bucket label 
dw 
dw 
dw 
dw 
dw 
dw 
dw 


near 

OFFFFH_; This is the only bucket. 

OFFFFH 

1002H_ ; Adding string indexes 1000..1002 
1000H 

offset acme__ptrs ; address of pointer list 
segment acme__ptrs 


segment acme_name_ ; segment of all strings 


: Do the function call to add bucket. 


/ 


MOV 
MOV 
MOV 
MOV 
PUSH 
INT 
POP 


BP, V_SYSTEM , HP vector 12H 


AH, F__STR__PUT__BUCKET _ ; function 44H 
DI, offset acme__bucket 


ES, segment acme__bucket 


DS / EX-BIOS Destroys DS 
HP__ENTRY ; Int 6FH for EX-BIOS 
DS 


F_STR_GET_STRING (AH = 46H) 


Given an index, this function searches the list of bucket headers for the bucket pointer with the 
given index. It returns a pointer to the string. 


F__STR__GET__STRING (46H) 


On Entry: BP = V__SYSTEM (12H) 
AH = 
BX = String index 
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On Exit: AH 
CX 


DS:SI 
ES:D| 


Registers Altered: AH, CX, SI, DI, BP, DS, ES 


RS__ SUCCESSFUL if index found in a bucket 
How many characters are in the string exclusive of the byte count and the 


zero byte at the end. 


Address of header where string was found. 
Pointer to first character of the string. 


Example: Search for the name of the ACME__INT routine as index 1000H. 


MOV _ BP, 
MOV 
MOV 
PUSH 
INT 


; Write the string to the screen: 


V_ SYSTEM 


AH, F__STR__GET__STRING 


BX, 1000H 
DS 
HP__ENTRY 


, HP vector 12H 
; Function 46H 


~ ~ 


~ e 


Index of ACME__INT name string 
' EX-BIOS destroys DS 


Int 6FH for EX-BIOS 


MOV AX, F10__.WRS__00 ; Call the write string function. 
MOV BP, SI ; Offset of string address 
PUSH DS ; Segment of string address 
POP ES ; CX Is already set 

MOV Dx,0 ; Cursor position at (0,0) 
MOV BH, O , Video page 0 

MOV BL, 7 , Character attribute 

INT INT__VIDEO ; Video interrupt 10 

POP DS ; Recover old DS 


F_STR_GET_INDEX (AH = 48H) 


Given a pointer to a string it returns the index of the string if it is in the bucket header list. 


On Entry: BP = V__SYSTEM (12H) 
AH = F__STR__GET__INDEX (48H) 
ES:DI_ = Pointer to first character of the zero terminated string. 


On Exit: AH = RS__ SUCCESSFUL if index was found. 
BX = Index found for the given string. 


Registers Altered: AH, BX, BP, DS 
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Example: Get the index of the ACME__NAME string. 


BP, V__SYSTEM , HP vector 12H 

AH, F__STR__GET__INDEX _ ; function 48H 

DI, seg ACME__NAME , Move segment of string 
ES, DI ; into ES 

DI, offset ACWME_NAME 

DS , EX-BIOS destroys DS 
HP__ENTRY , Int 6FH for EX-BIOS 

DS 


ACME__NAME__INDEX, BX _ ; Save the index. 
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SECTION 10. SYSTEM PROCESSES 


10.1 Overview 


This section describes system processes contained in the ROM BIOS. System processes are 
different from drivers in that they are not readily accessible to application programs and they 
perform larger tasks than a typical driver function. The ROM BIOS has five main system 
processes; reset, power-on self test (POST), system generation (SYSGEN), booting (BOOT), and 
return from protected mode. 


10.2 Reset 


The 80286 is reset through a hardware reset signal. This signal sets the CS and IP registers to 
begin execution at memory location OFOOO:O0FFFOH. The system can be reset by either a 
hardware reset to the 80286, or by any software routine that jumps to memory location 
OFOOO:OFFFOH. There are four events that initiate a system reset: 


@ Power-on. This reset occurs when power is applied to the system. The power supply resets 
the 80286 through its reset signal when the system is turned on. POST is initiated and 
performs a full memory test. 


@ Hard Reset. This reset is initiated by the <CTRL>-<Alt>-<Sys req> key sequence. This 
sequence generates a scancode that is interpreted by the HP-HIL controller as a system reset. 
The HP-HIL controller asserts the Non-Maskable Interrupt (NMI) line when this scancode 
sequence is detected. The default interrupt service routine for the NMI interrupt (02H) in turn 
jumps to the reset memory location. This reset is a superset of the industry standard. POST is 
initiated and performs a full memory test. 


@ Soft Reset. This reset is initiated by the <CTRL>-<Alt>-<DEL> key sequence. This 


sequence Is interpreted by the INT O9H keyboard interrupt service routine as a reset 
command. POST is initiated. A full memory test is not performed. 
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@® Programmatic Reset. The final reset source is a software initiated hardware reset. A 
command is sent to the 8041 controller to pulse the 80286 hardware reset line. Once the 
80286 has been placed in the Protected Mode, a hardware reset is the only method available 
to return to the Real Mode. POST may or may not be performed depending upon the shut 
down status byte in CMOS. 


Once a reset operation has been initiated by one of the four possible sources, the system must 
determine if it is a power-on reset. If it is a power-on reset, bit 2 in the 8041 controller's status 
port is cleared. POST is performed. A command is sent to the 8041 to set bit 2. If it is nota 
power-on reset, bit 2 in the 8041 controller status port is already set. The CMOS shutdown 
status byte determines whether POST is performed. 


If it is not a power-on reset, the system looks at the shut down status byte (CMOS address OFH) 
to determine whether to perform POST or return from protected mode. If the shut down status 
byte is set to one of the values that indicates the system is returning from protected mode, the 
reset process will initiate the return from protected mode process. This process is described next. 
All other values of the shut down status byte are interpreted as reset commands, and the reset 
process will initiate the power-on self test process. The reset process has completed its tasks 
when one of these two processes has been invoked. 


10.3 Protected Mode Support 


The 80286 processor has two modes of operation. Protected mode provides memory protection, 
virtual memory addressing, and a 16 MB physical address space. Real mode provides a 1 MB 
address space and an 8086 compatible mode. The normal mode of operation of the system is 
real mode. However, a few programs use protected mode, for example, VDISC.SYS, the DOS 
virtual disc device driver. 


The system provides some support to the programmer for use of the protected mode features. 
The INT 15H driver provides two functions that support system operation in protected mode. 
One of these functions enables data to be moved to and from extended memory. This function 
enters protected mode to perform this task, and returns to real mode. The second function 
provides a method for programmers to switch into protected mode. These functions are 
described in Section 9 of this manual. 
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10.3.1 Shut Down Status Byte 


The shut down status byte is used by the system to determine what action should be taken on 

reset. Table 10.1 shows how the shut down status byte is interpreted. Note that any value that 
does not indicate a return from protected mode is interpreted by the system as a reset, and will 
cause the reset process to invoke POST. 


Table 10.1 


Shut Down Status Byte 


Value Definition 


OO-O4H Perform power-on reset sequence. 

OSH Flush keyboard and jump via double word stored at 0040:0067H. 
06-O07H Perform power-on reset sequence. 

O8H Return from test of extended memory. 

OOH Return from INT 15H block move function. 

OAH Jump via double word stored at 0040:0067H. 

OBH-FFH Perform power-on reset sequence. 


The values 08H and O9H are used internally by the ROM BIOS. If the return from protected mode 
process detects either of these values, it will branch to their respective routines. Values OSH and 
OAH should be used by all other programs returning from protected mode. 


10.4 Power-On Self Test (POST) 


Each time the system is powered-on, or a reset is performed, the POST process is executed. The 
purpose of the POST process is to verify the basic functionality of the system components and to 
initialize certain system parameters. The POST process performs the following tasks: 
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Initialize the video display for diagnostic messages. 

Test the operation of the 80286. 

Test the system ROM. 

Test and initialize 8254 timer/counter and start the refresh counter. 

Test and initialize DMA controllers and DMA page registers. 

Test the first 64KB of system RAM. 

Test and initialize the 8259A interrupt controllers. 

Test the 8041 controller. 

Test the HP-HIL controller and link. 

Test CMOS RAM for integrity. 

Determine if manufacturing electronic tool is present, if so, run manufacturing test. 
Test the remaining base system RAM (RAM above the first 64KB. 

Test the extended RAM above memory address 100000H. (protected mode RAM.) 
Test the real-time clock portion of the RTC/CMOS chip. 

Test the flexible disc controller subsystem. 


Test the 80287 co-processor if present. 


The power on self test performs tests on various sub-systems in the hardware when power is 
switched on or when the system is reset. If a problem is detected, a 4 digit hex error code is 
displayed. (In order for the code to be displayed, the video display adapter must be a multimode, 
a monochrome, or a color adaptor.) These codes are listed in table 10.2. 


POST then compares the configuration information stored in the CMOS memory with the actual 
system. If a discrepancy is found, a message will be displayed instructing the user to run the 
SETUP utility. For example, if the CMOS memory indicates two flexible disc drives present, but 
the system contains only one, the message will be displayed. 
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If the POST process is initiated by a soft reset, the RAM tests are not executed. This portion of 
POST determines the amount of system memory and performs a test of that memory. In all other 
aspects, POST executes the same for power-on, hard reset, and soft reset. 


10.5 System Generation (SYSGEN) 


When the POST code module has completed its tasks, it initiates the system generation (SYSGEN) 
process. The SYSGEN process initializes the system software, then initiates the boot process. In 
general, the system data structures are initialized by the SYSGEN process, whereas the system 
hardware Is initialized by the POST process. For example, the STD-BIOS and EX-BIOS data areas 
are initialized by the SYSGEN process. SYSGEN initializes the following items: 


@® Interrupt vectors 

@ STD-BIOS data area 

@ £EX-BIOS data area 

The interrupt vectors are initialized to their default values. Processor interrupt vectors are 
initialized to their appropriate service routines. Hardware interrupt vectors are initialized to their 
service routines, or a null routine if they are unused. The interrupt vectors used to access the 
STD-BIOS drivers are initialized to their respective driver entry points. 

The STD-BIOS data area fields are initialized to their default values. Configuration dependent 
fields such as the base I/O address of the serial and parallel ports, current video mode, etc. are 


initialized at this time. 


The EX-BIOS data area is set up next in the SYSGEN process. Initializing the EX-BIOS data area 
consists of several distinct steps as outlined below. 
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Table 10.2 


Diagnostic Error Codes Displayed by POST 


Error Code 


0001 to OOOFH 


0010 
0011 


0110 to 
0200 to 


0300 to 
0401 
1000 to 


2110 to 
2120 to 
2131H 
2132H 
2210 to 


3000 to 


O12FH 
O2FFH 


O37FH 


12FFH 


211FH 
212FH 


221/7H 
30FFH 


400FH 
4OFOH 
410FH 
41FQOH 


420FH 
42FOH 
430FH 
43FOH 


440FH 
44FQH 
4SQOFH 
45FQOH 


460FH 
46FOH 
470FH 
47FQH 
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Test 


80286 chip 


ROM checksum 
ROM checksum 


RTC test 
CMOS test 


8041 test 
System error. 


Timer chip test 


DMA test 
DMA test 
DMA test 
DMA test 
DMA test 


HP-HIL controller 


RAM test 
RAM test 
RAM test 
RAM test 


RAM test 
RAM test 
RAM test 
RAM test 


RAM test 
RAM test 
RAM test 
RAM test 


RAM test 
RAM test 
RAM test 
RAM test 


Description 
80286 chip failed. 


ROM 0 fails checksum test. 
ROM 1 fails checksum test. 


Real-time clock failed. 
Real-time clock failed. 


8041 keyboard controller failed. 


Could not set A20 line. 


Timer chip failed 


DMA chip 1 failed. 
DMA chip 2 failed. 
DMA chip 1 failed. 
DMA chip 2 failed. 
Page register failed. 


HP-HIL controller failed. 


128k bank 0 d0O-d3 
128k bank 0 d4-d7 
128k bank O d8-d11 
128k bank 0 d12-d15 


128k bank 1 d0-d3 
128k bank 1 d4-d7 
128k bank 1 d8-d11 
128k bank 1 d12-d15 


128k bank 2 d0O-d3 
128k bank 2 d4-d7 
128k bank 2 d8-d11 
128k bank 2 d12-d15 


128k bank 3 d0Q-d3 
128k bank 3 d4-d7 
128k bank 3 d8-d11 
128k bank 3 d12-d15 


Error Code Test Description 


4800 to 480FH RAM test 128k bank 4 d0-d3 
4810 to 48FOH RAM test 128k bank 4 d4-d7 
4900 to 490FH RAM test 128k bank 4 d8-d11 

4910 to 49FQH- RAM test 128k bank 4 d12-d15 


5000 to SFFFH _ Reserved for Manufacturing test. 


6100 to 6113H RAM test Address line defined by the last 2 digits 
failed. (Hex) i.e. 6111 = address line 11h 
=al7 failed. 


7100 to 71FFH 8259 test Master 8259 failed. 


7200 to 72FFH 8259 test Industry Standard (STD) slave failed. 
7300 to 73FFH 8259 test HP slave failed. 

7400H 8259 test Master 8259 failed. 

7500H 8259 test Industry Standard (STD) slave failed. 
7500H 8259 test HP slave failed. 


8300 to 83FFH ~ Hard disc Controller/drive failed. 
8400 to 8FFFH Reserved for manufacturing test. 
9001 to 9Y1FFH _ Flexible Disc Flexible disc controller problem. 


9200 to 9YFFFH Reserved for manufacturing test. 
AOO2 to AQDOFH 80287 co-proc. Internal problem with 287. 


BOO1 to BOO?7H Multimode Video adapter problem. 
BOO8H Multimode Video adapter RAM problem. 


COOO to CFFFH - Extended RAM Extended RAM failure. 
Where: OCO00 to OCOFFH = > even byte is bad 
OC100 to OC1FFH = > odd byte Is bad. 
xx0O to xxFEH = > bad RAM at address 
O0* 10000H to OFE* 10000H 


example: if error = 0C124H then: 

1 > odd byte Is bad. 
> error Is in 128K bank starting at address: 
O24H*10000H = 0240 OOOH 


24 


if error = OCOF1H then: 

O => even byte is bad. 

F1 = > error is in 128K bank starting at address: 
OF1H*10000H = OF10 OOOH 


ODOOO to OFFFFH Reserved for manufacturing test. 


System Processes 319 


10.5.1 Memory Allocation 


The first step in the process is to allocate system memory for the EX-BIOS data area. This memory 
allocation algorithm has two important features. First, by taking the memory size stored in CMOS 
memory into consideration, it allows large driver data areas to be allocated in the EX-BIOS data 
area. This method of expanding the EX-BIOS data area is explained in Section 9. Second, it 
prevents invalid CMOS memory size data from preventing the system from booting. If the CMOS 
memory size is set (using the SETUP utility or writing directly to the CMOS memory) such that 
there is insufficient room for the EX-BIOS data area, this algorithm will adjust the value and write 
the new value to CMOS memory. The EX-BIOS data area is required to support the EX-BIOS 
extended features. 


There are three important variables in this calculation. 


@ RAM_SIZE—This is the top of actual system memory. It is usually 256, 512, or 640 KB and 
will always be an even multiple of 64 KB. 


@ £EX-BIOS__SIZE—This variable is the size of the EX-BIOS data area, which is 4 KB in its default 
configuration. 


@ CMOS_ SIZE—This is the memory size stored in CMOS. 


The CMOS__SIZE is checked for validity. If it is between 4 KB and 64 KB from RAM_SIZE, this 
value is used as the base of the EX-BIOS data area. If CMOS__SIZE is more than 64 KB from 
RAM__SIZE, the base of the EX-BIOS data area is located 64 KB below the top of actual system 
memory. Finally, if CMOS__SIZE is less than 4 KB from the top of RAM__SIZE (or greater than the 
top of actual memory), the base of the EX-BIOS data area is located 4 KB from the top of system 
memory. The following formulas show this relationship: 


If (RAM__SIZE—CMOS__SIZE) > 4KB and < 64KB 
then EX-BIOS__SIZE = (RAM__SIZE—CMOS__SIZE). 


If (RAM__SIZE—CMOS__SIZE) > 64KB 
then EX-BIOS__SIZE = 64KB. 


If (RAM__SIZE—CMOS__SIZE) < 4KB 
then EX-BIOS__SIZE = 4KB. 


The following examples illustrate this relationship: 
In a 640 KB system, if CMOS__SIZE is 512 KB then the EX-BIOS__SIZE data area starts at 600 
KB. This leaves an 88 KB free area between the EX-BIOS__SIZE data area and the memory 
allocated to DOS. 
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In a 640 KB system if CMOS__SIZE is 620 KB then the EX-BIOS___SIZE data area starts at 620 
KB. In this case the EX-BIOS__SIZE data area occupies all the area between the top of RAM 
and the memory allocated to DOS. 


10.5.2 HP__VECTOR_ TABLE Initialization 


Once the EX-BIOS data area has been allocated, and its base address determined, the 
HP__VECTOR__TABLE is constructed. An image of the default HP__VECTOR__TABLE is stored in 
the system ROM. This image Is transferred from ROM to the base of the EX-BIOS data area. All 
free and reserved vectors are initialized to point at V__DOLITTLE, a null routine. Some of these 
vectors will be initialized to other drivers later in the SYSGEN process. 


10.5.3. EX-BIOS Driver Initialization 


The next step in the SYSGEN process is the initialization of the EX-BIOS drivers. Each driver is 
called with the SF__INIT subfunction. Some of the EX-BIOS drivers add vectors to the table when 
called to initialize. For example, the V__HPHIL driver initializes the vector addresses reserved for 
the HP-HIL physical device drivers. The HP__VECTOR_TABLE is fully initialized to its default state 
when each driver has been called in this manner. Additional drivers may be added or substituted 
by application programs or system software utilizing the vector maintenance functions of 
V__SYSTEM (refer to Section 9 for a description of these functions). 


10.5.4 Option ROM Module Integration 


The ROM BIOS architecture allows code modules residing on adapter cards to be integrated into 
the system. These ROM modules must be in the system address range of OCOOOOH—ODFFFFH. 
(Note that only video adapter cards can have base address in the range of OCOOOOH through 
OC7FFFH). In addition to ROM modules located on adapter cards, the processor extension card 
contains sockets for additional ROMs. These ROMs are addressed from OEQOOOH—OEFFFFH. 
ROM modules located on adapter cards or on the processor extension card are integrated into 
the system in the same manner. 
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All ROM modules contain a header and checksum byte. The header format is shown below: 


Byte O—55H 

Byte 1—OAAH 

Byte 2—Length of ROM module in 512 byte blocks. 
Byte 3—Initialization entry point. 


Bytes 0 and 1 are signature bytes. All ROM modules must contain this signature at the start of 
the header in order to be identified by the SYSGEN process. 


Byte 2 of the header contains the number of 512 byte blocks in the ROM module, except the 
ROM module located on the processor extension card (memory address OEOOOOH). Byte 2 in that 
ROM module header is reserved. 


During the boot process, the address range from OC8000H to ODFFFFH is scanned in 2 KB blocks 
looking for valid option ROM headers. In addition, memory location OEOOOOH is also examined 
for a valid header. Since the scan does not proceed past OEOOOOH, only one ROM module can 
reside in the address range OEQOOOH to OEFFFFH. The processor extension card will accept two 
different size ROMs; 32 KB or 64 KB. If a 32 KB part is installed, the ROM will appear in the 
system address space starting at location OE8000H instead of OEOOOOH. Therefore, the 32 KB 
ROM will not be integrated into the system by SYSGEN. 


If a valid ROM header is found, a checksum is computed for the ROM module. This is done by 
summing each byte in the ROM module. The sum of all the bytes in the ROM, including the 
checksum byte, must equal 0. For ROM modules located from OCOOOOH to ODFFFFH, the 
checksum is computed for the number of bytes indicated in the length field of the header. For a 
ROM module located from OEQOOOH to OEFFFFH this checksum is calculated on the entire 64 KB 
of address space. 


If the checksum is valid, a FAR call to byte 3 of the module is is performed. The ROM module 
should perform any initialization required and then execute a RETF instruction. 


This integration process allows option ROMs to install vectors in either the HP__VECTOR__TABLE 


or the low memory interrupt vectors. This re-vectoring process is the typical method used to 
integrate ROM modules into the system. 
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10.6 Boot Process (INT 19H) 


The boot process loads the operating system. The ROM BIOS INT 19H loads the boot sector from 
drive ““A:" or “’C:"". This sector must contain the bootstrap loader for the operating system. 
Control is then passed to the code loaded from the boot sector. This code is responsible for 
loading the operating system. Refer to the appropriate operating system reference 
documentation for additional information on its boot process. 


10.6.1 Booting From a Flexible Disc 


The INT 19H driver attempts to read the boot sector from Drive ‘A: (disc 0). It will retry the read 
four times before failing. The boot sector on flexible discs is located on Side O, Track O, Sector 1. 
Table 10.3 contains a description of the contents of a valid boot sector. If drive ‘‘A:"’ contains a 
disc that does not have a valid boot sector, then the system will report the error message: 


Non-System disc or disc error 
Replace and strike any key when ready. 


If a valid boot sector is found, it is read into memory starting at location O7COH:0000H (07COOH) 
and control is transferred through a FAR JUMP to location 07COH:OOOOH. It is the responsibility 
of this code to load the rest of the operating system into memory. 


10.6.2 Booting From a Hard Disc 


If the flexible disc drive does not contain a disc, the system will attempt to boot from the hard 
disc. Booting from a hard disc is a two step process. First, the active partition must be 
determined, then the boot record is read from the active partition. 


The hard disc can be divided into as many as four partitions. Each partition contains an operating 
system, programs, and data. Only one of the partitions can be active at any time. Partitions are 
added, deleted, activated, and deactivated using utilities provided with the respective operating 
systems. Partitions occupy a specified number of cylinders on the disc. For example, the optional 
20 MB hard disc drive has 606 cylinders. One partition might occupy cylinders 0 through 303, 
while the second partition occupied cylinders 304 through 605. 
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Table 10.3 


Boot Record 


Offset Description 


3 Bytes 
8 Bytes 
1 Word 
1 Byte 

1 Word 
1 Byte 

1 Word 


1 Word 
1 Byte 

1 Word 
1 Word 
1 Word 
1 Word 


478 Bytes 


1 Word 


Near JUMP instruction to boot code. 
OEM name and version number. 
Bytes per sector. 

Sectors per allocation unit. 

Reserved sectors. 

Number of File Allocation Tables (FATs). 
Number of root directory entries. 
Number of sectors in logical image. 
Media descriptor. 

Number of FAT sectors. 

Sectors per track. 

Number of heads. 

Number of hidden sectors. 

Boot code. 

55AAH signature word. 


The first physical sector (cylinder 0, head 0, sector 1) of the hard disc contains the master boot 
record. The master boot record contains a code module and the disc partition table. The disc 
partition table contains the starting and ending cylinder of each of the disc partitions, as well as 


a flag that indicates whether the partition Is active or not. Table 10.4 contains a description of 
the master boot record. 


Table 10.4 


Hard Disc Master Boot Record 


Offset 


QOOOH 
O1BEH 


O1CEH 
O1DEH 
Q1EEH 
O1FEH 
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446 Bytes 


16 Bytes 
16 Bytes 
16 Bytes 
16 Bytes 
1 Word 


Description 


Master boot code. 
Partition table entry #1. 
Partition table entry #2. 
Partition table entry #3. 
Partition table entry #4. 
OAA5S5H signature word. 


A partition entry consists of 16 bytes. It contains information specifying the location of the 
partition, type of operating system, and a flag to indicate if the partition is active. Table 10.5 
details the partition table entry. 


Table 10.5 


Partition Table Entry Record 


Size Description 


1 Byte Boot indicator. 

1 Byte Starting head number. 

1 Byte Starting sector number. 

1 Byte Starting cylinder number.* 

1 Byte System indicator. ** 

1 Byte Ending head number. 

1 Byte Ending sector number. 

1 Byte Ending cylinder number.* 

2 Words Number of sectors in preceding partitions. 
2 Words 


Total number of sectors in partition. 


* The actual cylinder number is a ten bit value composed of the cylinder byte plus the two 
most significant bits of the associated sector byte. These two bits are the most significant bits 
of the ten bit number. 


** System indicators are: 


OOH = Unknown operating system 
O1H = DOS (12 bit FAT) 
04H = DOS (16 bit FAT) 


The INT 19H code will load the code module contained in the master boot record into memory, 
then transfer control to it. This code scans the data in the disc partition table to determine the 
active partition, and its starting cylinder. The first sector of the active partition becomes the 
logical boot sector of the partition, and it contains a boot record. The boot record has the same 
format as the boot record contained on a flexible disc, except that some of the parameters are 
adjusted for the increased capacity of the hard disc partition. Refer to table 10.3 for the format 
of a typical boot record. 


System Processes 325 


326 System Processes 


APPENDICES 


TABLE OF CONTENTS 
A. BIOS INTERRUPTS 


Cctv dete b bbb bbb bbb bbb bbb bbb eeeeeeee a, 331 
A.1 Interrupt Vector Assignments.............0000. 331 
A.2 STD-BIOS Interrupt and Functions.............. 334 
A.3 EX-BIOS Drivers and Functions....__.............................. 339 
B. MEMORY MAP _____............. ooo. 349 
B.1 System Memory Map.........00.0.000.. ee. 349 
B.2 STD-BIOS Data Structures... 350 
B.2.1 RS-232 Communication Port Addresses...................... 351 
B.2.2 Parallel Printer Port Addresses............................. 352 
B.2.3 Equipment Byte Data Area...) 352 
B.2.4 Keyboard Data Area... eee. 353 
B.2.5 Flexible Disc Data Area... ee. 355 
B.2.6 Video Display Data Area......... ee. 357 
B.2.7 Option ROM Data Area................0.0.000.000............. 358 
B.2.8 Timer Data Area... eee. 358 
B.2.9 System Data Flags... ee. 358 
B.2.10 Hard Disc Data Area... ee. 359 
B.2.11 Printer Timeout Counters......................... 2.00220. 359 
B.2.12 Keyboard Buffer Pointers.................................... 360 
B.2.13 Enhanced Graphics Adapter (EGA) Data Area............. 360 
B.2.14 Flexible Disc Rate Area... ........... 00. 360 
B.2.15 Extended Hard Disc Data Area............................... 361 
B.2.16 Extended Flexible Disc Data Area........................... 361 
B.2.17 Keyboard Mode Indicator .................................., 362 
B.2.18 Real-time Clock Data Area... 363 
B.2.19 Pointer to EGA Data Area............................0 0. 364 


Appendices 327 


B.2.20 Intra-application Communications Area.................... 364 


B.2.21 Print Screen Status ......... eee. 364 

B.2.22 DOS Data Area........ cee ee. 365 

B.2.23 Reserved Data Areas.......... 6. cee 365 
B.3 EX-BIOS Data Area Map ...................0..000.000.000..000.... 365 

B.3.1 Option ROM Data Segments................................5. 367 

B.3.2 EX-BIOS Global Data Area......................0000 00 367 
B.4 ROM BIOS Memory Map ...........................0....00...... 369 
B.5 Product Identification ..........0. oes: 370 
C. CMOS MEMORY LAYOUT AND 

REAL-TIME CLOCK ce. 371 
C.1 Real-Time Clock/CMOS Access..................0..0..000.00... 372 
C.2 Real-Time Clock (CMOS Address OOH-ODH)................. 373 
C.3 Diagnostic Status Byte (CMOS Address OEH).............. 375 
C.4 System Shutdown Byte (CMOS Address OFH).............. 375 
C.5 Diskette Descriptor Byte (CMOS Address 10H)............ 376 
C.6 CMOS Fixed Disc Type (CMOS Address 12H)............... 377 
C.7 Equipment Byte (CMOS Address 14H)....................... 377 
C.8 System Base RAM Size 

(CMOS Address 15H-16H)...........00.. 00 ee. 377 
C.9 System Extended Memory Size 

(CMOS Address 17H-18H) ...............0....0000.0000 020. 378 
C.10 EX-BIOS Checksum Byte (CMOS Address 28H) ........... 379 


C.11 EX-BIOS Reserved Bytes (CMOS Address 29H-2CH) ..... 379 
C.12 STD-BIOS Checksum Word 


(CMOS Address 2EH-2FH).......................0.0..0000. 0005. 380 
C.13 Test Information Byte (CMOS Address 33H).............. 380 
D. I/O Port Map... ence. 381 
D.1 DMA Channel Controller... eee. 382 


328 Appendices 


D.1.1 1/O Port Addresses for DMA Controllers..................... 383 


D.2 8259A Interrupt Controllers... , 385 
D.3 8254 Timer Controller (I/O Ports 40H through 43H)...... 389 
D.4 Keyboard Data Buffer (60H)...........0000000000000 ee. 389 
D.5 SPU Control Port (61H)... 389 
D.6 Speaker Control 000.000. 390 
D.7 Keyboard I/O Ports... cece. 391 
D.8 Real Time Clock Ports cece eee. 391 
D.9 Hard Reset Enable Port... ss... ccc ee. 392 
D.10 NMI Sources and Involved I/O Ports........................ 392 
E. SYSTEM EQUATE FILE ..................00...000000000 00020002: 395 
E.1 The Equate File. ccc, 396 
F. DEFAULT DEVICE MAPPING .................................. 423 
G. DRIVER WRITER’S GUIDE .......................00000002222... 425 
G.1 Who Should Read This Appendix ............................. 425 
G.2 Introduction «dooce. 425 
G.3 Installation of Device Drivers ..........................0.002..: 426 
G.4 Initialization 0c ccc eee, 427 
G.4.1 Product Identification ............ 6... eee. 427 
G.4.2 Obtaining Memory From the EX-BIOS....................... 428 
G.4.3 Getting a Free Vector... eee 429 
G.5 EX-BIOS Driver Functions..............................0.02020... 429 
EX-BIOS Driver Function Definitions..........................0.-0000--00. 431 
F_ISR (AH = OOH)......... 431 

F__ SYSTEM (AH = O2H)......... 432 

SF__INIT (AX = O0200H)......... 432 

SF__ START (AX = 0202H)......... 432 
SF__REPORT__STATE (AX = 0204H)......... 433 
SF__VERSION__ DESC (AX = 0206H)......... 433 
SF__DEF__ATTR (AX = 0208H)......... 434 
SF__GET__ATIR (AX = 020AH)......... 434 


Appendices 329 


SF__SET__ATTR (AX = 020CH)......... 434 


SF__OPEN (AX = O20EH)......... 435 
SF__CLOSE (AX. = 02104). oveee ces 435 
SF__TIMEOUT (AX = 0212H)......... 435 
SF__INTERVAL (AX = 0214H)......... 436 
SF__TEST (AX = 0216H)......... 436 
F_|O__CONTROL (AH = O4H)......... 436 
SF__LOCK | (AX = 0400H)......... 436 
SF__UNLOCK (AX = 0402H)......... 437 
F__PUT__BYTE (AH = O6H)......... 437 
F__GET__BYTE (AH = O8H)......... 437 
F__PUT__BUFFER OR F__PUT__BLOCK (AH = OAH)......... 437 
F__GET__BUFFER OR F__GET__BLOCK (AH = OCH)......... 438 
F__PUT__WORD (AH = OEH)......... 439 
F__GET__WORD (AH = 10H)......... 439 

G.6 Return Status Codes... ne. 440 
G.7 Driver Headers... cee eee 441 
G.7.1 HP__SHEADER Fields .....0.0...0.0. 0.0 ccc cccc ccc ee eee 442 
G.7.2 Driver Mapping..............0.0 00.00. 446 
G.8 Accessing Driver from an Application. ..................... 446 
G.9 Examples of EX-BIOS Drivers...............00 0, 447 
G.9.1 Cursor Pad Scan Code To HP Mouse Driver ................. 421 
G.9.2 Application Resident EX-BIOS Driver ........................ 461 
G.9.3 Non-HP-HIL Input Devices........................0.0.0.0.00.... 461 

H. ASCIl AND SCANCODE CONVERSION TABLES........ 483 
l. HEXADECIMAL ARITHMETIC... 489 


330 Appendices 


APPENDIX A 


A. BIOS INTERRUPTS 


This appendix contains three tables. The first lists the interrupt vector assignments. The second 
lists each of the STD-BIOS interrupts with supported functions. The third lists the EX-BIOS drivers; 
their vector addresses, functions and subfunctions. 


A.1 Interrupt Vector Assignments 


Table A.1 


Interrupt Vector Assignments 


Address Int Function Service Routine** 
000-003H O Divide by Zero PI STD-BIOS (UI) 
O04-007H 1 Single Step PI STD-BIOS (Ul) 
O08-O0OBH 2 Nonmaskable Interrupt P| STD-BIOS 
OQOC-OOFH 3 Breakpoint P| STD-BIOS (UI) 
010-013H 4 Arithmetic Overflow P| STD-BIOS (UI) 
014-017H 5 Print Screen SW STD-BIOS (DRVR) 
018-01BH 6 Invalid Opcode P| STD-BIOS (Ul) 
O1C-O1FH 4 Reserved PI STD-BIOS (Ul) 
O20-023H 8 Timer Interrupt (IRQ 0) HW STD-BIOS 
024-027H 9 Keyboard ISR (IRQ 1) HW STD-BIOS 
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Address int Function Type* Service Routine** 


O28-O2BH A Reserved ( ) STD-BIOS 
O2C-O2FH B Serial Port 1 ISR (IRQ 3) HW STD-BIOS = (UI) 
030-033H C Serial Port O ISR (IRQ 4) HW STD-BIOS (UI) 
034-037H OD Printer Port 1 ISR (IRQ 5) HW STD-BIOS (UI) 
038-O3BH E Diskette ISR (IRQ 6) HW STD-BIOS 
O3C-O3FH F Printer Port 0 ISR ( ) STD-BIOS 
040-043H 10 Video SW STD-BIOS (DRVR) 
O44-047H 11 Equipment Check SW STD-BIOS (DRVR) 
048-O04BH 12 Memory Size SW STD-BIOS (DRVR) 
O4C-O4FH 13 Diskette/Hard Disc SW STD-BIOS (DRVR) 

14 STD-BIOS  ( ) 
054-057H 15 System Functions SW STD-BIOS (DRVR) 
O58-O5BH 16 Keyboard SW STD-BIOS (DRVR) 
O5C-O5FH 17 Printer STD-BIOS (DRVR) 

18 Reserved N/A (IRET) 

19 STD-BIOS — ( 

1A Time and Date SW STD-BIOS (DRVR) 
O6C-O6FH 1B Keyboard Break SW STD-BIOS  (IRET) 
O70-073H 1C Timer Tick SW STD-BIOS  (IRET) 

1D Video Parameter Table STD-BIOS 

1E Diskette Parameter Table STD-BIOS 
O7C-O7FH 1F Graphics Character Table PT STD-BIOS 


O080-083H 20 Program Terminate SW DOS 
084-087H 21 DOS Function Calls SW DOS 
088-O8BH DOS Terminate Address PT DOS 


O8C-O8FH DOS <CTRL>-<Break> 


Address SW DOS 
090-093H 24 DOS Critical Error SW DOS 
094-097H 25 DOS Absolute Disc Read SW DOS 


098-O9BH DOS Absolute Disc Write 


O9C-O9FH DOS Terminate Stay Resident 


OAO-OCBH 28-32 Reserved for DOS DOS 
OCC-OCFH 33 HP Mouse Service SW EX-BIOS  (DRVR) 
ODO-OFFH 34-3F Reserved for DOS SW DOS 

100-103H 40 Alternate Diskette SW STD-BIOS 
104-107H 41 Hard Disc Parameter Table (0) PT STD-BIOS 
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Address ___ Int Function Type* Service Routine** 
SW STD-BIOS 


Hard Disc Parameter Table (1) PT STD-BIOS 
-17FH 47-5F Reserved SW STD-BIOS 
a -19FH 60-67 Reserved for User Programs SW N/A 
68 8041 Service Request ISR HW EX-BIOS 
Keyboard OBF ISR HW EX-BIOS 
Reserved HW EX-BIOS 
Reserved HW EX-BIOS 
HP-HIL Controller ISR HW EX-BIOS 
Reserved HW EX-BIOS 
Reserved HW EX-BIOS 
EX-BIOS Entry Point SW EX-BIOS 
Real-time Clock ISR (IRQ 8) HW STD-BIOS 
SW Redirected (IRQ 9) HW STD-BIOS 
Reserved HW STD-BIOS 
Reserved HW STD-BIOS 
Reserved HW STD-BIOS 
Coprocessor HW STD-BIOS 
Hard Disc ISR HW STD-BIOS 
> Reserved HW -STD-BIOS 


1EQO-1FFH 78-7F Not Used 
200-3C3H 80-FO Reserved 
3C4-3FFH F1-FF Not Used 


* Pl = —Processor interrupt 
HW —Hardware interrupt 
SW —Software interrupt 
PT —lInterrupt vector used as pointer to data. 
N/A —Not applicable 


**Ul —Unused Interrupt ISR 
IRET —Interrupt Returned 
DRVR—Application callable Entry Point 


‘i The following table lists the STD-BIOS interrupt vectors, their usage and, where appropriate, their 
functions. 
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A.2 STD-BIOS Interrupts and Functions 


Table A.2 


STD-BIOS Interrupts and Functions 


Function 
Equate 


INT__ VIDEO 
F1Q__SET__MODE 
F10__SET__CURSIZE 
F1Q__SET__CURPOS 
F10__RD__CURPOS 
F10__RD__PENPOS 
F1O__SET__PAGE 
F10__SCROLL__UP 
F10__SCROLL__DN 
F10__RD__CHARATR 


F1O0_.WR__CHARATR 
F10__WR__CHARCUR 


F1O__SET__PALLET 
F10__WR__PIXEL 
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Function 
Value 


Definition 


Divide by zero 
Single step 
Nonmaskable interrupt 
Breakpoint 
Arithmetic overflow 
Print screen 

Invalid opcode 
Reserved 

Timer interrupt 
Keyboard ISR 
Reserved 

Serial port 1 ISR 
Serial port 0 ISR 
Printer port 1 ISR 
Diskette ISR 

Printer port O ISR 


Video 

Set video mode 

Set cursor size 

Set cursor position 
Read cursor position 
Read light-pen position 
Set active display page 
Scroll rectangle up 
Scroll rectangle down 


Read character and attribute at 


cursor position 


Write character and attribute at 


cursor position 


Write character at cursor position 


Set color pallet 
Write pixel 


INT Function Function 
Hex Equate Value Definition 


F1O__RD__PIXEL ODH Read pixel 
F10__WR__CHARTEL QEH Write teletype character 
F10__GET__STMODE OFH Get video state and mode 
10H-12H Reserved 
Write string functions 


F10__WRS__OO 1300H global attribute 
F10__WRS__01 1301H global attribute, move cursor 
F10__WRS__02 1302H individual attributes 
F10__WRS__03 1303H individual attributes, move cursor 
F10__INQUIRE 6FOOH EX-BIOS present 
F10__GET__INFO 6FO1H Get video parameters 
F10__SET__INFO 6FO2H Set video parameters 
F10__MOD__INFO 6FO3H Modifies video parameters 
F10__GET__RES 6FO4H Report video resolution 
F10__XSET__MODE 6FO5H Set video resolution 

11H INT__EQUIPMENT Equipment check 

12H INT__MEM__SIZE Memory Size 


*** Note that both hard disc and *** 
diskette share interrupt 13H 


INT__DISC Disc Functions 


F13__ RESET__DISC OOH Reset Disc 

F13__RD__LSTATUS O1H Read status of last operation 

F13__ RD__SECTORS O2H Read sectors 

F13__WR__SECTORS O3H Write sectors 

F13__VR__SECTORS O4H Verify sectors 

F13__ FORMAT__FLEX OSH Format flexible disc track 
O6H Reserved 

F13_ FORMAT__HDISC O7H Format hard disc 

F13__GET__HPARMS O8H Get hard disc parameters 
OOH-OBH_ Reserved 

F13__ TRACK__SEEK OCH Seek to track 

F13_ALT__RESET ODH Alternate hard disc reset 
QEH-O14H Reserved 

F13__GET__DASD 15H Read disc type (DASD) 

F13__CHG__ STATUS 16H Get disc change line status 


Pls. SET. DASD 17H Set disc type for formatting (DASD) 
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INT Function Function 


Hex Equate Value Definition 


INT__SERIAL Serial 
F14__ INIT OOH 
F14__ XMIT O1H 
F14__ RECV O2H 
F14__ STATUS O3H 
F14__ INQUIRE 6FOOH 


Initialize serial port parameters 
Send out one character 

Receive one character 

Get serial port status 

EX-BIOS present © 

Initializes serial port (19.2 Kbaud) 
Write a buffer of data 

Read a buffer of data 

Read a buffer of data, terminate on 


F14__ EXINIT 6FO1H 
F14__ PUT__BUFFER 6FO2H 
F14__ GET__BUFFER 6FO3H 
F14__TRM__BUFFER 6FO4H 


INT__SYSTEM 


F15__DEVICE__OPEN 80H 
F15_ DEVICE__CLOSE 81H 


F15__PROG__TERM 82H 
F15__WAIT__EVENT 83H 
F15_ JOYSTICK 84H 
F15_ SYS__ REQ 85H 
F15_ WAIT 86H 


F15__ BLOCK__MOVE 87H 
F15__GET__XMEM__SIZE 88H 
F15__ENTER__PROT 89H 
F15__DEV__BUSY 91H 
F15__INT__COMPLETE 8BH 


INT__ KBD 
F16__GET__KEY 
F16__ STATUS 
F16__KEY__ STATE 
F16__INQUIRE 


F16__DEF__ATTR 
F16__GET__ATTR 
F16__SET__ATTR 
F16__DEF__MAPPING 
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specified condition 


System functions 
Unsupported (turn on cassette 
motor) 

Unsupported (turn off cassette 
motor) 

Unsupported (read data blocks) 
Unsupported (write data blocks) 
Device open 

Device close 

Program termination 

Event wait 

Joystick support 

System request key pressed 
Wait fixed amount of time 
Extended memory transfer 
Get extended memory size 
Switch to protected mode 
Device busy hook 

Set Interrupt Completed Flag 


Keyboard 

Read keycode from keyboard buffer 
Report status of keyboard buffer 
Get key modifier status 

EX-BIOS present 

Report default typematic values 
Report typematic values 

Set typematic values 

Report default translator 
assignments 


INT Function 
Hex 


Equate 


F16__GET__MAPPING 
F16__SET__MAPPING 
F16__SET__XLATORS 
F16__ KBD 
F16__KBD__RESET 


INT__PRINTER 
F17__ PUT__CHAR 
F17__INIT 

F17__ STATUS 
F17__INQUIRE 


F17__PUT__BUFFER 


18H 
19H INT__BOOT 


INT__CLOCK 
FIA__RD__CLK__CNT 
FIA SET__CLK__CNT 
FIA__GET__RTC 

FIA _SET__RTC 
FIA__GET__DATE 
FIA__SET__DATE 
FI1A__SET__ALARM 
FIA__RESET__ALARM 


28H-32H 


Function 
Value 


6FO5H 
6FO6H 
6FO?H 
6FO8H 
6FO9H 


OOH 
O1H 
O2H 
6FOOH 
6FO1H 
6FO2H 
6FO3H 
6FO4H 


OOH 
O1H 
O2H 
O3H 
O4H 
OSH 


Definition 


Report translator assignments 
Set translator assignments 
Set CCP and softkey pads 
Report keyboard information 
Reset keyboard to defaults 


Printer 
Send printer one byte 
Initialize printer port 

Get printer port status 
EX-BIOS present 

Reserved 

Write a buffer to printer port 
Reserved 

Reserved 


Reserved 
Boot 


Time and date 
Read current clock count 

Set current clock count 

Read real-time clock 

Set real-time clock 

Read date from real-time clock 
Set date in real-time clock 

Set alarm 
Reset alarm 


Keyboard break 
Timer tick 
Video parameter table 

Diskette parameter table 

Graphics character table 

Program terminate 

DOS function calls 

DOS terminate address 

DOS <CTRL>-<Break> address 
DOS critical error 

DOS absolute disc read 
DOS absolute disc write 
DOS terminate stay resident 
Reserved for DOS 
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INT Function Function 
Hex Equate Value Definition 


INT__HPMOUSE HP Mouse service 
F33__INSTALL OOH Mouse installed flag 

F33__ ENABLE O1H Put cursor on screen 

F33__ DISABLE O2H Turn off cursor 

F33__ REPORT__DATA O3H Get position/button information 
F33__ PUT__CURSOR O4H Position the cursor 
F33__REPORT__PRESS OSH Report button press status 
F33__REPORT__RELEASE O6H Report button release status 
F33__SET__HORIZ O7H Set min/max horizontal values 
F33__SET__VERT O8H Set min/max vertical values 
F33__GRAPH__CURSOR O9H Define graphics cursor 
F33__TEXT__CURSOR OAH Define text cursor 

F33__ MOTION OBH Report motion counters 

F33__ SET__USR OCH Define user subroutine 

F33_ ENABLE_ LIGHT ODH Unsupported 

F33__ DISABLE_LIGHT  OEH Unsupported 

F33_ RATIO OFH Set pixel movement ratio 
F33__COND__OFF 10H Define conditional off area 
F33__ RESERVED 11H Reserved 

F33__XTEND__GCSR 12H Extended sprite graphics entry point 
F33__ SPEED 13H Sets mouse movement doubling 
F33__ INQUIRE 6FOOH EX-BIOS mouse driver present 


Reserved for DOS 
Alternate Diskette 
Hard Disc Parameter Table (0) 
Reserved 
Hard Disc Parameter Table (1) 
Reserved 
Reserved for User Programs 
8041 Service Request ISR 
Keyboard OBF ISR 
Reserved 
Reserved 
HP-HIL Controller ISR 
Reserved 
Reserved 
HP__ENTRY EX-BIOS Entry Point 
Real-timie Clock ISR 
SW redirected 
Reserved 
Reserved 
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Function Function 
Equate Value 


80H-FOH 
F1H-FFH 


Definition 


Reserved 
Coprocessor 
Hard Disc ISR 
Reserved 
Not Used 
Reserved 
Not Used 


A.3 EX-BIOS Drivers and Functions 


Many additional features of the HP system can be accessed through the software interrupt INT 
6FH. To call the EX-BIOS extensions, the BP register must contain the vector address of the 
desired driver, the AH register must contain the function code, and the AL register must contain 
the subfunction code. The rest of the registers are available for passing data and returning data 


to and from the routine. 


In general the AX, BP and DS registers are not preserved. They must be preserved by the calling 
routine if it needs them. See Section 2 for an example showing how EX-BIOS drivers are called. 


Table A.3 


EX-BIOS Drivers and Functions 


Vector Func. Function 
Address Value  Equate 
QOO0OH V__SCOPY 
QO06H V__DOLITTLE 
OOOCH V__PNULL 


V__SYSTEM 
00 F__ISR 


O02 F_SYSTEM 


Definition 

Copyright Notice Routine 
NOP Routine (IRET) 

Null device driver 


System Management Functions 
Interrupt service routine 
(unsupported) 

Standard driver functions 


02/00 SF__INIT 


System initialization 
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Vector 


Func. Function 


Address Value Equate Definition 

0012H O04 F__INS__BASEHPVT Returns HP__VECTOR__TABLE 
segment 

0012H 06 F__INS__XCHGFIX Exchanges fixed table entries 

0012H 08 F__INS__ XCHGRSVD Sets next “‘reserved”’ entry in 
table 

Q012H OA F__INS__ XCHGFREE Sets next ‘‘free’’ entry in table 

0012H OC F__INS__ FIXOWNDS Install fixed vector, user 
supplied DS 

0012H OE F__INS_ FIXGETDS Install fixed vector, system 
supplies DS 

0012H 10 F__INS__FIXGLBDS Install fixed vector, DS set to 
global data area 

0012H 12 F__INS__ FREEOWNDS Install next free vector, user 
supplies DS 

0012H 14 F__INS__FREEGETDS Install next free vector, system 
supplies DS 

0012H 16 F__INS__FREEGLBDS Install next free vector, DS set 
to global data area 

0012H 18 F__INS__FIND Search for matching device 
header 

0012H 1A Reserved* 

0012H 1C Reserved* 

0012H 1E F__RAM__GET Get EX-BIOS memory pool 
address and size 

0012H 20 F__RAM__RET Set memory pool address and 
size 

0012H 22 F__CMOS__GET Read and verify CMOS memory 

Q012H 24 F__CMOS__RET Write to CMOS memory 

0012H 26 Reserved* 

0012H 28 Reserved* 

0012H 2A F__YIELD Just returns 

0012H 2C Reserved* 

O012H 2E Reserved* 

0012H 30 F__SND__CLICK__ ENABLE Enable keyclick 

0012H 32 F_ SND__CLICK__ DISABLE Disable keyclick (Default) 

0012H 34 F__SND__CLICK Execute keyclick if enabled 

0012H 36 F__SND__BEEP__ENABLE Enables beep 

0012H 38 F__SND__BEEP__DISABLE Disables beep 

O012H 3A F__SND__BEEP Beeps if enabled 

Q012H 3C F__SND__SET__BEEP Sets beep frequency 

0012H 3E F__SND__ TONE Produce tone, user suppled 
duration and frequency 

Q012H 40 F__STR__GET__FREE__INDEX Return next free string index 

0012H 42 F__STR__DEL__BUCKET Delete bucket string list 

0012H 44 F__STR__PUT__BUCKET Add bucket to current string list 
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‘a 


Vector 


Address 


Func. 
Value 


46 
48 


Function 
Equate 


F__STR__GET__STRING 
F__STR__GET__INDEX 


Definition 


Search the list for index, return 
string 


Search list for a string, return 
index 


0018H Reserved* 

OO1EH V__ $8259 8259 interrupt controller 
support 

OO1EH 00 F__ISR Unsupported 

QO1EH O02 F_ SYSTEM System functions 

QO1EH O2/00 SF__INIT Initialize HP slave 8259A 

OO1EH 02/02 SF__START Enable HP slave 8259A 
interrupts 

QO1EH 02/06 SF__VERSION__DESC Report HP version number 

QO1EH O04 F_|O__ CONTROL Entry point to I/O control 
functions 

OO1EH 04/00 SF__ENABLE__SVC Unmask svc/8041 interrupt 

QO1EH 04/02 SF__DISABLE__SVC Mask svc/8041 interrupt 

OQO1EH 04/04 SF__ENABLE__KBD Unmask keyboard INT 9 
interrupt 

QO1EH 04/06 SF__DISABLE__KBD Mask keyboard INT 9 interrupt 

QO1EH 04/08 SF__ENABLE__HPHIL Unmask HP-HIL interrupt 

OO1EH O4/0A SF__DISABLE__HPHIL Mask HP-HIL interrupt 

O024H Reserved* 

OQO2AH V__SINPUT Inquire Commands 

OO2AH 00 F__ISR Pass ISR Event Record to 
physical driver 

OO2AH 02 F__ SYSTEM System Functions 

OO2AH 02/00 SF__INIT Supported 

OO2AH O4 F_IO__CONTROL Entry point to I/O control 
functions 

OO2AH 04/00 SF__DEF__LINKS Set header link fields to system 
defaults 

OO2AH 04/02 SF__GET__LINKS Return device header link field 
entries 

OO2AH 04/04 SF__SET__LINKS Set device header link field 
entries 

OO2AH 06 F__ INQUIRE Return describe record for an 
HP-HIL device 

OO2AH 08 F__INQUIRE__ALL Return device IDs for all HP-HIL 
devices present 

OO2AH OA F__INQUIRE__FIRST Return vector address of first 


F__REPORT__ENTRY 


HP-HIL device driver 
Report entry point of PGID 
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Vector Func. 


Address 


0036H 
0036H 
0036H 
0Q036H 


OQO3CH 
OO3CH 
OO3CH 


0042H 


0042H 
0042eH 
0042H 


0048H 


O0048H 
0048H 
0048H 


0054H 
0054H 
0054H 
0054H 


O054H 


O054H 
0054H 


O054H 


0054H 
0054H 
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00 
02 
02/06 


00 
02 
02/00 
02/06 


00 
02 
02/06 


00 
02 
02/06 


00 
O2 
02/06 


00 
02 
04 
04/00 
04/02 


04/04 


04/06 


04/08 
04/0A 


Function 


Value Equate 


V__QWERTY 

F__ISR 

F_ SYSTEM 
SF__VERSION__DESC 


V__SOFTKEY 
F__ISR 

F__ SYSTEM 
SF__INIT 
SF__VERSION__DESC 


V__FUNCTION 


F__ISR 
F__ SYSTEM 
SF__VERSION__DESC 


V__NUMPAD 


F__ISR 
F_ SYSTEM 
SF__VERSION__DESC 


V__CCP 
F__ISR 


F__ SYSTEM 
SF__VERSION__DESC 


V__SVIDEO 

F__ISR 

F_ SYSTEM 

F_ IO__ CONTROL 
SF__VID__ID__HP 
SF__VID__GET__INFO 


SF__VID__SET__INFO 


SF__VID__MOD__INFO 


SF__VID__GET__RES 
SF__VID__SET__MODE 


Definition 


Reserved* 
QWERTY keypad translator 
Translates to PC scan code. 
System functions 

Reports HP version number 


Physical HP softkey translator 
Translates to PC scan code 
System functions 

Driver initialization 

Report HP version number 


Industry standard function key 
translator 

Logical Interrupt 

System functions 

Report HP version number 


Ind. standard numeric Key Pad 
Translator 

Logical Interrupt 

System functions 

Reports HP version number 


Cursor Control Key Pad 
Translator 

Logical Interrupt 

System functions 

Reports HP version number 


Video Functions 

Interrupt service routine 
Standard driver functions 
Driver dependent control 
functions 

Returns the value “HP” in BX 
register 

Return video display adapter 
information 

Set info. on Extended Control 
Register of the Multimode 
Video Adapter 

Modify Extended Control 
Register of Multimode Video 
Adapter 

Get the resolution of active 
video adaptor 

Set video mode of active 
Display adapter 


Vector 


Address 


OOSAH 
OO5AH 
OOSAH 
OQOSAH 
OOSAH 
OOSAH 
OOSAH 
OOSAH 
OOSAH 
OOSAH 
QOSAH 
OOSAH 
OOSAH 


O060H 


0066H 


OO6CH 


O072H-84H 


OO8AH 
OO8AH 
OQO8AH 
OO8AH 


OO90H 
OO90H 
OO90H 
OO90H 


0096H 


OO96H 
O096H 
O0O96H 


OO9CH 


OO9CH 
OO9CH 
OO9CH 


OOAZ2H 


OOA8H 


Func. 


Value 


00 
O2 
02/00 
02/02 
04 
06 
08 
OA 
OC 
OE 
10 
12 


Oe 
02/06 


00 
Oe 
02/06 


00 
Oe 
02/06 


00 
Oe 
02/06 


Function 
Equate 


V__STRACK 

F__ISR 

FS YotEM 
SF__INIT 
SF__START 

F__TRACK__INIT 

F__TRACK__ON 

Fe RACK UOEF 

F__DEF__MASKS 

F__SET__LIMITS__X 

F__SET__LIMITS__Y 

F__PUT__SPRITE 

F__REMOVE__SPRITE 


V__EVENT__TOUCH 


V__ EVENT. TABLET 


V__EVENT__POINTER 


V__CCPCUR 

F__ISR 

F__ SYSTEM 
SF__VERSION__DESC 


V__ RAW 

F__ISR 

F_ SYSTEM 
SF__VERSION__DESC 


V__CCPNUM 


F__ISR 
F__SYSTEM 
SF__VERSION__DESC 


V__OFF 


F__ISR 
F_ SYSTEM 
SF__VERSION__DESC 


Vie CCPGID 


V__SKEY2FKEY 


Definition 


Sprite control 

Update sprite 

System functions 

Initialize driver 

Start driver 

Sets tracking to default state 
Enables tracking 

Disables tracking 

Define sprite masks 

Set max/min horizontal values 
Set max/min vertical values 
Display sprite 

Remove sprite from display 
Application access to touch 
events 


Application access to tablet 
events 


Application access to pointer 
events 


Reserved* 


Cursor control pad translator 
Logical Interrupt 

System functions 

Returns HP version number 


Return untranslated CCP data 
Logical Interrupt 

System functions 

Returns HP version number 


Translate scancodes from 
Numeric Pad 

Logical Interrupt 

System functions 

Returns HP version number 


Discards CCP and HP softkey 
scancodes 

Logical Interrupt. 

System functions 

Returns HP version number 


Translates CCP data to 
T__REL16 data 


HP softkeys to function key 


translator 
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Vector Func. Function 


Address Value Equate Definition 

OOA8H QO F__ISR Logical Interrupt 

OOA8H 02 F_ SYSTEM System functions 

OOA8H 02/06 SF__VERSION__DESC Returns HP version number 


OOAEH V__8041 8041/keyboard interface. 
provides HP extensions to INT 
16H 

Processes ISR event record 


System functions 


OQOAEH F__ISR 
OOAEH F__SYSTEM 


QOAEH 
OOAEH 
OOAEH 
OOAEH 
OOAEH 
OOAEH 
OOAEH 
OQOAEH 
QOAEH 
OOAEH 
OOAEH 
QOAEH 
OOAEH 
OQOAEH 


SF__INIT 
SF__START 
SF__VERSION__DESC 


F__IO__CONTROL 
through 04/08 


SF__CREAT__INTR 
SF__DELET__INTR 
SF__ENABL__INTR 
SF__DISBL__INTR 
SF__SET__RAMSW 
SF__CLR__RAMSW 
SF__SET__CRTSW 
SF__CLR__CRTSW 
SF__PASS__THRU 


Initializes driver 

Driver Start-up 

Reports HP version number 
Driver Dependant Functions 
Reserved * 

Create interval entry 

Delete interval entry 
Enable interval 

Disable interval 

Set RAM switch to one (1) 
Set RAM switch to zero (0) 
Set CRT switch to one (1) 
Set CRT switch to zero (0) 
Pass data byte to 8041 


OOAEH through 04/2E 
OOB4H V__PGID__CCP 


Reserved* 


Translate GID info to cursor 
control pad format 
Application interface to Tablet 
Logical Interrupt 

System functions 


OOBAH V__LTABLET 
OQOBAH F__ISR 
OOBAH F_ SYSTEM 


OOBAH 
OOBAH 
OOBAH 
OOBAH 
OQOBAH 


OOBAH 
OQOBAH 
OOBAH 
QOBAH 
OOBAH 
OOBAH 
QOBAH 
OOBAH 


OOBAH 
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02/08 
02/0A 


04/08 
O04/0A 


SF__INIT 

SF__START 
SF__REPORT__STATE 
SF__VERSION__DESC 
SF__DEF__ATTR 


SF__GET__ATTR 
SF__SET__ATTR 


F_ IO__ CONTROL 


SF__LOCK 
SF__UNLOCK 
SF__TRACK__ON 
SF__TRACK__OFF 
SF__CREATE__EVENT 


SF__EVENT__ON 


Initialize the driver data area 
Start driver 

Report state of device 

Report driver version number 
Set default logical scaling 
attributes 

Get scaling attributes 

Set scaling attributes 

(0 Control Functions 
Unsupported 

Unsupported 

Turns cursor track on 

Turns cursor track off 
Establish a new routine to be 
called on logical device events 
Enable event call to parent 
driver 


Vector Func. Function 
Address Value Equate Definition 


04/0C SF__EVENT__OFF 


Disable event call to parent 


driver 
QOBAH O4/0E SF__CLIPPING__ON Enable logical device clipping 
OQOBAH 04/10 SF__CLIPPING__OFF Disable logical device clipping 


F__SAMPLE 
V__LPOINTER 


Report absolute position of GID 


OOBAH 06 

OOCOH Application interface to Pointer/ 
Mouse 

QOCOH O00 F__ISR Logical Interrupt 

OOCOH O02 F__ SYSTEM System functions 

OOCOH 02/00 SF__INIT Initialize the driver data area 

OOCOH 02/02 SF__START Start driver 

OOCOH 02/04 SF__REPORT__STATE Report state of device 

OOCOH 02/06 SF__VERSION__DESC Report driver version number 

OOCOH 02/08 SF__DEF__ATTR Set default logical scaling 


attributes 

OOCOH O2/0A SF__GET__ATTR Get scaling attributes 

OQOCOH O2/0C SF__SET__ATTR Set scaling attributes 

QOCOH O04 F_ IO CONTROL /O Control Functions 

OOCOH 04/00 SF__LOCK Unsupported 

OQOCOH 04/02 SF__UNLOCK Unsupported 

OOCOH 04/04 SF__TRACK__ON Turn cursor track on 

OOCOH 04/06 SF__TRACK__OFF Turn cursor track off 

OOCOH 04/08 SF__CREATE__EVENT Establish a new routine to be 
called on logical device events 

OOCOH O4/0A SF__EVENT__ON Enable event call to parent 
driver 

OOCOH 04/0C SF__EVENT__OFF Disable event call to parent 
driver 

OOCOH Q4/0E SF__CLIPPING__ON Enable logical device clipping 

OOCOH 04/10 SF__CLIPPING__OFF Disable logical device clipping 


OOCOH 06 F__ SAMPLE 
V__LTOUCH 


Report absolute position GID 


Application interface to Touch 
Screen 

OOC6H O00 F__ISR Logical Interrupt 

OOC6H O02 F__SYSTEM System functions 

OOC6H O2/00 SF__INIT Initialize the driver data area 
OOC6H 02/02 SF__START Start driver 

OOC6H 02/04 SF__REPORT__STATE Report state of device 

OOC6H 02/06 SF__VERSION__DESC Report driver version number 


OOC6H 02/08 SF__DEF__ATTR Set default logical scaling 
attributes 

OOC6H O2/0A SF__GET__ATTR Get scaling attributes 

OOC6H O2/0C SF__SET__ATTR Set scaling attributes 

OQOC6H O04 F__|IO__ CONTROL /O Control functions 


SF__LOCK Unsupported 
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Vector Func. Function 


Address Value Equate Definition 
OOC6H SF__UNLOCK Unsupported 
OOC6H SF__TRACK__ON Turn cursor track on 
OOC6H SF__TRACK__OFF Turn cursor track off 
OOC6H SF__CREATE__EVENT Establish a new routine to be “ 
called on logical device events 
OOC6H SF__EVENT__ON Enable event call to parent 
driver 
OOC6H SF__EVENT__OFF Disable event call to parent 
driver 
OOC6H SF__CLIPPING__ON Enable logical device clipping 
QOC6H SF__CLIPPING__OFF Disable logical device clipping 
OOC6H F__ SAMPLE Report absolute position of GID 
V__LHPMOUSE Interface to Microsoft Mouse 
driver 
F__ISR Logical Interrupt 
F_ SYSTEM System Functions 
SF__INIT Initializes driver 
SF__START Starts driver 
F_ IO__CONTROL /O control driver functions 
SF__MOUSE__COM BIOS mouse install function 
SF__MOUSE__OVERRIDE Set speed factor ~ 
0108H V__NULL No driver | 
O10EH Reserved* 


V__HPHIL Setup HP-HIL to INPUT driver 
linkage 
F__ISR Logical Interrupt 
F__SYSTEM System Functions 
SF__INIT Initializes the driver data area 
SF__REPORT__STATE Reports state of device 
SF__VERSION__DESC Reports driver version number 
SF__OPEN Put driver in open state 
SF__CLOSE Put driver in closed state 
F_ |O__CONTROL I/O control to driver 
04/06 SF__CRV__RECONFIGURE ce HP-HIL to reconfigure all 
evices 
04/08 SF__CRV__WR__PROMPTS Write a prompt to a device 
O4/0A SF__CRV__WR_ACK Write an acknowledge to a 
device 
04/0C  SF_CRV__REPEAT Sets either 30Hz or 60Hz repeat = | 
rate 
04/0€ SF__CRV__DISABLE__REPEAT Cancel keyboard repeat rate 
04/10 SF__CRV__SELF__TEST Issue self-test command to 
physical device 
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Vector Func. Function 
Address Value Equate Definition 


04/12 SF__CRV__REPORT__STATUS Get status from any HP-HIL 
device that needs to report 

04/14 SF__CRV__REPORT__NAME _ Returns the ASCII name for a 
device 

04/16 SF__KEYBOARD__REPEAT Set typematic values 

04/18 SF__KEYBOARD__LED Sets keyboard LED states 

06 F__PUT__ BYTE Write one byte to specified 
HP-HIL device 

08 F__GET__BYTE Read one byte from specified 
HP-HIL device 

OA F__PUT__BUFFER Write a string of bytes to HP-HIL 
device 


011AH-1C2H Reserved* 


1C8H-228H Vectors available (16) 


XX XH** Keyboard Driver Processes scancodes form 
HP-HIL driver 
00 F__ISR Logical Interrupt 
O02 F__SYSTEM System Functions 


02/00 SF__INIT Driver initialization 
02/06 SF__VERSION__DESC Reports HP version number 


XXXH** HP-HIL driver vectors Physical HP-HIL driver vectors 
1 thru 7 
OO F__ISR Logical Interrupt 
O02 F_ SYSTEM System functions 
02/00 SF__INIT Initialize driver 
02/02 SF__START Start driver 
02/04 SF__REPORT__STATE Unsupported 
02/06 SF__VERSION__DESC Report HP version number 


XXxXH** Available Vectors Inquiry on availability of free 
vector in HP__VECTOR__TABLE 


*Vectors marked reserved should not be used. 


**Vectors with addresses xxxH do not have a fixed location. Their location is determined at 
power-on depending on the system’s configuration. 
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APPENDIX B 


B. MEMORY MAP 


B.1 System Memory Map 


The system maintains ROM and RAM entry point compatibility with the industry standard. Table 


B.1 provides an outline of the first megabyte of memory. 


Table B.1 


Memory Map 


Starting 
Description Address 


Interrupt Vectors Q000:Q000H 
STD-BIOS Data Area 0040:0Q000H 
Scratch 0050:001EH 
Bios Stack 0060 :Q000H 
DOS 0070:0000H 


Application QCO0:0050H 
EX-BIOS System RAM 


n is dependent upon the amount of memory installed. 
The EX-BIOS takes a minimum of 800 hex bytes. 


Max RAM Equal 256KB 
Max RAM Equal 640KB 


Boot Address O07CQ:Q000H 


Absolute 


Begin 


QOOOOH 
O0400H 
O051EH 
OO600H 
00700H 


OCOS5OH 
nF800H 


QOOOQOH 
OOO00H 


O/7COQOH 


End 


OO3FFH 
Q051DH 
OOSFFH 
OO6FFH 


nF800H 
nFFFFH 


3FFFFH 
OFFEFH 
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Starting Absolute 
Description Address Begin End 


Reserved Video Buffer : AOQOQOOH 

Monochrome Video Buffer : BOOOOH B/FFFH 
Color Video Buffer : B8000H BFFFFH 
Video ROM Space : COOOOH C/FFFH 


IHV ROM : C8000H 


SPU IHV ROM Space :QQO0H EQOOOH 
BIOS ROM :>QO00H FOQOOOH 
BIOS ROM :QO00H F8000H 
RESET Vector OOOOH FFFFOH 


B.2 STD-BIOS Data Structures 


The data area for the STD-BIOS is in absolute memory locations 00400H through OO5FFH, which 
conforms to the industry standard. Table B.2 summarizes the assignments within this block of 
memory. A detailed description of these data fields follows the summary. 


Table B.2 
STD-BIOS Data Area 


Address Function 


4Q00H-407H = RS-232 Communication Port Addresses 
4O08H-40FH Parallel Printer Port Addresses 
410H-416H Equipment Flag 
417H-43DH Keyboard Data Area 
43Eh-448H _ Flexible Disc Data Area 


449H-466H Video Display Data Area 
46/7H-46BH Option ROM Data Area 
46CH-470H Timer Data Area 
471H-473H System Data Flags 
474H-477H — Hard Disc Data Area 
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Address 


478H-47FH 
480H-483H 
484H-488H 
489H-48AH 
48BH-48BH 


48CH-48FH 
490H-496H 
497H-497H 


498H-4AQOH 
4A1H-4A7H 


4A8H-4ABH 
4ACH-4EFH 
4FOH-4FFH 
500H-SO0OH 
501H-503H 


S504H-504H 
SOSH-SFFH 


Function 


Printer Timeout Counters 

Keyboard Buffer Pointers 

Enhanced Graphics Adapter (EGA) Data Area 
Reserved 

Flexible Disc Data Rate Area 


Extended Hard Disc Data Area 

Extended Flexible Disc Data Area 
Keyboard Mode Indicator/LED Data Area 
Real-Time Clock Data Area 

Reserved 


Pointer to EGA Data Area 

Reserved 

Intra-application Communication Area 
Print Screen Status 

Reserved 


DOS Data Area 
Reserved 


B.2.1 RS-232 Communication Port Addresses 


The I/O port addresses of up to four serial communication adapter ports are stored in these four 
words. 


40:000H O02 S40__RS232_ PORT1__ADR Address of serial port 1 
40:002H O02 S40__RS232_ PORT2__ADR Address of serial port 2 
40:004H O02 S40__RS232__PORT3__ADR Address of serial port 3 
40:006H O02 S40__RS232_ PORT4__ADR Address of serial port 4 
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B.2.2 Parallel Printer Port Addresses 


The I/O port addresses of up to four parallel printer adapter ports are stored in these four words. 


40:008H 
40:00AH 
40:00CH 
40:00EH 


B.2.3 Equipment Byte Data Area 


02 


02 


02 


02 


S40__PRINT__PORT1__ADR 
S40__PRINT__PORT2__ADR 
S40__PRINT__PORT3__ADR 


S40__ PRINT__PORT4__ADR 


Address of parallel port 1 
Adaress of parallel port 2 
Address of parallel port 3 


Address of parallel port 4 


This data area contains several words describing some of the optional hardware installed in the 


system. 


40:010H 


40:012H 
40:013H 
40:015H 
40:016H 
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O2 


S40__ EQUIPMENT__FLAG 


S40__ MFG__INIT 
S40__ MEMORY__SIZE 
S40__MFG__ERR__FLAG1 


S40__MFG__ERR__FLAG2 


Installed devices word 
(see table B.3) 


Manufacturing initialization/test byte 
Memory size in 1k bytes 
Manufacturing scratchpad 


Manufacturing error codes 


“ 


‘a 


Table B.3 
Equipment Flag (40:010H) 


Value Definition 


no printers installed 
one printer installed 

two printers installed 

three printers installed 
reserved 

no RS-232 ports installed 
one RS-232 port installed 
two RS-232 ports installed 
three RS-232 ports installed 
four RS-232 ports installed 
O8H reserved 


2 
3 
ODH-OCH —— 
0 
1 
2 
3 
A 
O7H-O6H O 1 flexible disc drive installed, if bit O = 1 
1 
0 
1 
2 
3 
0 
1 
0 
1 


OBH-O9H 


2 flexible disc drives installed, if bit O = 1 
OSH-O4H video adapter is not monochrome or color 
initial video mode of 40-column color 
initial video mode of 80-column color 
initial video mode of 80-column monochrome 
reserved 
math co-processor not present 
math co-processor present 
no disc drives present 
some number of flexible disc drives present, see bits 7-6 


O3H-O2H 
O1H 


OOH 


B.2.4 Keyboard Data Area 


This area is used by the keyboard driver to store keyboard states, scancodes and keycodes. 


40:017H O1 S40__KBD_STATE1 State of special keys: shift, caps, etc. 
(see table B.4). 


40:018H 01 S40__KBD__STATE2 - Secondary state of special keys 
(see table B.5). 
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40:019H 
40:01AH 
40:01CH 
40:01EH 


Table B.4 


01 


02 


02 


20 


S40__ALT__INPUT_ACCUM Accumulator for alt/numpad entry 
S40__KBD__BUF__HEAD Keyboard buffer head pointer 
S40__KBD__BUF__TAIL Keyboard buffer tail pointer 
S40__KBD__BUFFER Keyboard buffer, room for 15 


entries + overrun 


Keyboard State Mask Byte1 (40:17H) 


Bit Data 


O7H 0 
aon | 
os | 
ot | 
a | 
ca | 
om | 
con | 
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Definition 


nsert state inactive 
nsert state active 


Caps lock state inactive 
Caps lock state active 
Num lock state inactive 
Num lock state active 
Scroll lock state inactive 
Scroll lock state active 


<Alt> key not depressed (inactive) 
<Alt> key depressed (active) 
<CTRL> key not depressed (inactive) 
<CTRL> key depressed (active) 


Left <Shift> key not depressed (inactive) 
Left <Shift> key depressed (active) 

Right <Shift> key not depressed (inactive) 
Right <Shift> key depressed (active) 


Table B.5 


Keyboard State Mask Byte2 (40:18H) 


Data Definition 


<Ins> key not depressed 
<Ins> key depressed 

< Caps lock> key not depressed 
< Caps lock > key depressed 
<Num lock> key not depressed 
<Num lock> key depressed 
<ScrLck > key not depressed 
<Scrlck> key depressed 

Pause state (< CTRL>-<Num lock >) inactive 
Pause state active 

<Sys req> key not depressed 
<Sys req> key depressed 
Reserved 


0 
1 
0 
1 
0 
1 
0 
1 
0 
1 
0 
1 


B.2.5 Flexible Disc Data Area 


This area is used by the flexible disc driver to store information about current drive activity. 


40:03EH O01 S40 __FLOPPY__SEEK__STAT Drive recalibration status 
(see table B.6) 


40:03FH 01 S40__FLOPPY__MOTOR_STAT _ Drive motor status 
(see table B.7) 


40:040H 01 #£S40__FLOPPY__TIME__OUT Drive timeout counter 
(see table B.8) 


40:041H 01 S40__FLOPPY__RETURN__STAT _ Drive return code/error status 


40:042H O07 S40__FLOPPY__CONTRL_STAT Controller status/hard disc command/ 
parm port copies 
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Table B.6 
Flexible Disc Seek Status Byte (40:03EH) 


Data Definition 


Disc hardware interrupt occurred 

Reserved 

Indicates drive 1 needs recalibration before next seek 
Indicates drive 1 does not need recalibration before next seek 
Indicates drive 0 needs recalibration before next seek 
Indicates drive 0 does not need recalibration before next seek 


Table B.7 
Flexible Disc Motor Status Byte (40:03FH) 


Data Definition 


Current operation is not a write 
Current operation is a write 
Reserved 

Drive one Is not selected 

Drive one Is selected 


Drive zero is not selected 

Drive zero is selected 

Reserved 

Drive one motor is not running 
Drive one motor is running 
Drive zero motor is not running 
Drive zero motor Is running 
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Table B.8 
Flexible Disc Drive Error Status (40:041H) 


Data Definition 


1 Timeout error; disc failed to respond in time 
1 Seek error; seek to track failed 
1 Controller error; disc controller chip failed 
O4H-OOH 1 Bad command; invalid command request 
2 Address error; address mark on disc not found 
3 Write protect error 
4 Sector not found; unable to locate sector, disc damaged or 
unformatted 
6 Media changed; the drive door was opened on a 1.2MB disc 
drive 
8 DMA error; DMA failed to respond in time 
9 Segment wrap; attempt to perform DMA across a segment 
boundary 
10H CRC error; crc check on data failed 


B.2.6 Video Display Data Area 


This area is used by the video driver to store current screen parameters and cursor positions. 


40:049H 01 S40__CRT__MODE Current video mode 

40:04AH O02 S40__CRT_WIDTH Current # of screen columns 

40:04CH O02 S40__CRT__LENGTH Current length of screen in bytes 

40:04EH O02 S40__CRT__PAGE__ADR Starting address of current display page 

40:050H 10 S40__CRT__CURSOR_ POS Seid coordinates (row, column) up to 
pages 


40:060H O02 $S40__CRT__CURSOR_MODE Current cursor mode setting 


40:062H 01 S40__CRT__DISPLAY__PAGE Current display page 
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40:063H 02 S40__CRT__PORT_ADR 


40:065H 01 S40__CRT_MODE_SEL__REG 


40:066H 01 S40__CRT__PALETTE 


B.2.7 Option ROM Data Area 


This area is used by the POST (SYSGEN) routine. 


40:067H 02 S40_XROM_INIT_ADR 


40:069H 02 S40_XROM__SEGMENT 


40:06BH 01 S40_XROM_INT__FLAG 


B.2.8 Timer Data Area 


This area stores the current timer count and flags. 
40:06CH O02 S40__TIMR_LOW 
40:06EH O02 S40_TIMR_HIGH 


40:070H 01 S40__TIMR__OVR__FLOW 


B.2.9 System Data Flags 


Base I/O port address for active video 
controller 


Mode select register copy 


Color palette register copy 


Offset address for optional I/O rom init 
routine 


Segment address for optional I/O rom 


Flags last interrupt that occurred 


Least significant word of timer count 
Most significant word of timer count 


24-hour timer tick rollover counter 


This area used by the system to flag <CTRL>-<Break> and <CTRL>-<Alt>-<DEL> 


requests. 
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40:071H 01 
40:072H 02 


S40__SYS__BREAK__FLAG 
S40__SYS__RESET__FLAG 


B.2.10 Hard Disc Data Area 


System break request flag 


System reset flag 


This area is used by the INT 13H fixed disc driver to store current information about the fixed disc 


controller and status. 


40:074H 


40:075H 
40:076H 
40:077H 


B.2.11 Printer Timeout Counters 


01 


01 
01 
01 


S40__FD__STATUS 


S40__FD__COUNT 
S40__FD__CONTROL 
S40__ FD__PORT__OFFSET 


Hard disc status of last Int 13H 
operation 


Number of hard discs present 
Copy of hard disc controller register 


Hard disc port offset 


These tables contain timeout counts for the parallel and serial ports. The default value for the 


parallel printer port is 14H while the serial port is 01H. 
>078H 
>O79H 
40: 
40: 
40: 
40: 
40: 
40: 


40 
40 


O7AH 
O7BH 
O7CH 
O7DH 
O7EH 
O7FH 


01 
01 
01 
01 
01 
01 
01 
01 


S40__PRINT__TIMEOUT1 
S40__ PRINT__TIMEOUT2 
S40__PRINT__TIMEOUT3 
S40__PRINT__TIMEOUT4 
S40__RS232__ TIMEOUT1 
$40__RS232__ TIMEOUT2 
$40__RS232__ TIMEOUT3 
S40__RS232__ TIMEOUT4 


Parallel port 1 timeout count 
Parallel port 2 timeout count 
Parallel port 3 timeout count 
Parallel port 4 timeout count 
Serial port 1 timeout count 
Serial port 2 timeout count 
Serial port 3 timeout count 


Serial port 4 timeout count 
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B.2.12 Keyboard Buffer Pointers 


These pointers indicate where in memory the keyboard buffer is as opposed to the current access 
points to the buffer stored in the pointers above. This allows an application to move and enlarge 
the keyboard buffer. 


40:080H 02 S40_KBD__BUF_START Pointer to physical start of keyboard 
buffer 

40:082H O02 S40 _KBD__BUF__END Pointer to physical end of keyboard 
buffer 


B.2.13 Enhanced Graphics Adapter (EGA) Data Area 


This data area is used by the optional EGA driver when present. 


40:084H 01 S40_EGA_CRT__ROW__CNT Number of crt rows minus one 


40:085H O02 S40_EGA_CHAR_ SIZE Number of bytes per character in font 
table 

40:087H 01 S40__EGA_INFO1 EGA miscellaneous information 

40:088H 01 S40_EGA_INFO2 EGA miscellaneous information 

40:089H 02 Reserved 


B.2.14 Flexible Disc Rate Area 


This data area is used by the flexible disc driver to optimize performance on the 1.2mb drives by 
keeping track of the last data rate selected for disc access. 


40:08BH 01 S40_ FLOPPY__LAST__RATE Last data rate selected 
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B.2.15 Extended Hard Disc Data Area 


40:08CH 
40:08DH 
40:08EH 
40:08FH 


01 
01 
01 


01 


S40__AFD__STATUS__ REG 
S40__AFD__ERROR__REG 
S40__AFD__INTR__FLAG 


S40__AFD__CTRL__FLAG 


Hard disc status reg. copy 
Hard disc error reg. copy 
Hard disc interrupt flag 


Hard disc controller flag 


B.2.16 Extended Flexible Disc Data Area 


This data area is used by the flexible disc driver to store information about the current media in 


the drives and what operations are being performed on it. 


40:090H 


40:091H 
40:092H 
40:093H 
40:094H 
40:095H 
40:096H 


01 


01 
01 
01 
01 
01 


01 


S40__AFLOPPY__MEDIAO 


S40__AFLOPPY__MEDIA1 
S40__AFLOPPY__OPERO 
S40__AFLOPPY__OPER1 
S40__AFLOPPY__TRACKO 
S40__AFLOPPY__TRACK1 


S40__AFLOPPY__RESERVED 


Drive 0 media state 
(see table B.9) 


Drive 1 media state 
Drive 0 operation state 
Drive 1 operation state 
Drive O current track 
Drive 1 current track 


Flexible disc reserved byte 
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Table B.9 
Flexible Disc Media Byte (40:090H) 


Data Definition 


Data transfer rate is 500kb/sec 
Data transfer rate is 300kb/sec 
Data transfer rate is 250kb/sec 
Single step all seeks 

Double step all seeks 

Type of disc in drive unknown 


Type of disc in drive known 


Reserved 

Attempting 360k disc in 360k drive 
Attempting 360k disc in 1.2mb drive 
Attempting 1.2mb disc in 1.2mb drive 


Determined 360k disc in 360k drive 
Determined 360k disc in 1.2mb drive 
Determined 1.2mb disc in 1.2mb drive 


B.2.17 Keyboard Mode Indicator 


This byte is used by the keyboard driver to store the current state of the keyboard LED's. 


40:097H O01 S40_KBD__LED__FLAGS Keyboard LED flags 
(see table B.10) 
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Table B.10 
Keyboard LED Flag Byte (40:97H) 


Data Definition 


Reserved 
< Caps lock> LED Is off 
< Caps lock> LED Is on 


<Num lock> LED is off 
<Num lock> LED is on 


< Scroll lock > LED is off 
< Scroll lock > LED is on 


B.2.18 Real-time Clock Data Area 

This area is used by the RTC driver to store information needed to interrupt an application 

waiting on an RTC event. 
40:098H 02 S40__RTC__WAIT__OFFSET Offset address of user wait flag 
40:09AH O02 S40_RTC_WAIT_SEGMENT Segment address of user wait flag 
40:09CH O02 S40__RTC_WAIT__CNT_LOW Low word of wait count 
40:09EH O02 S40__RTC_WAIT__CNT_HIGH — High word of wait count 
40:0A0H 01 S40__RTC_WAIT_ACTV_FLG Wait active flag 
40:0A1H 07 Reserved 
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B.2.19 Pointer to EGA Data Area 


40:0A8H 04 S40_EGA_TBL_PTR Pointer to table of EGA pointers 


40:0ACH 2C Reserved 


B.2.20 Intra-application Communications Area 
Used by applications to communicate with each other and with themselves from one work 
session to another. 


40:0FO 10 S40__INTRA_APPL Available to any application 


B.2.21 Print Screen Status 


40:100H 01 S40__PSCRN__STATUS _ Flag for print screen in progress 
(see table B.11) 
40:101H 03 Reserved 
Table B.11 


Print Screen Status Byte (40:100H) 


Bit Data Definition 
O7H-OOH O Print not in progress 


1 Print in progress 
FFH Error during print 
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B.2.22 DOS Data Area 


The following data areas are used by DOS to provide status information on single-drive systems. 


40:104H 01 S40_ SINGLE__DRV__STAT Status of flexible disc for single drive 
systems, ie currently drive A: or B: 


40:105H 1A Reserved 


B.2.23 Reserved Data Areas 


The following areas are reserved and should not be used under any circumstances: 
40:089H 02 
40:Q0A1H 07 
40:O0ACH 2C 
40:101H 03 
40:105H 1A 


B.3 EX-BIOS Data Area Map 


Figure B.1 shows the EX-BIOS RAM space which contains the HP__VECTOR__TABLE, the EX-BIOS 
memory pool, and the EX-BIOS global data area. 


The following notes correspond to the letters in figure B.1. 
a. This address Is the segment (CS) value stored in the second word of the HP__ENTRY 


interrupt vector O6FH, the HP__VECTOR_TABLE Is at offset zero. This value may also be 
obtained from the V__SYSTEM driver, using function F_INS__BASEHPVT. 
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EX-BIOS Data Area Layout 


HP__VECTOR_TABLE 
HP_ENTRY’s CS:0 HP_VECTOR_ TABLE 
HP__ENTRY__CODE 


HP__ENTRY__CODE 
HP_ENTRY’s CS:IP 


“*“Max DS” 
EX-BIOS 
Memory 
Pool 
EX-BIOS 
“Last used DS”’ Memory 
EX-BIOS Resident Pool 


Driver’s Data 


Segments 
V_SYSTEM’s DS 
EX-BIOS Global! 
Data Segment 
TOP of RAM 
Figure B.1 


b. This address is the offset (IP) value stored in the first word of the HP__ENTRY interrupt 
vector O6FH. This address (CS:IP) represents the end of the HP__VECTOR__TABLE and 
points to the EX-BIOS’s HP__ENTRY__CODE. 


c. This address represents the last allocatable data segment (“MAX DS”) value available from 
the EX-BIOS memory pool. This address may be obtained as well as allocated from the EX- 
BIOS V__SYSTEM driver, see F_RAM__GET and F_.RAM__RET in Section 9. 


d. This address is passed to drivers requesting memory from the EX-BIOS memory pool. Drivers 
must first subtract the size of their data segment from the ‘‘last used DS” value to get an 
addressable data area. The new ‘‘last used DS” is returned to the EX-BIOS using the 
F__RAM__RET function. 


e. This address represents the EX-BIOS global data area used by drivers and services that share 
data. This address is the DS value stored in the HP_.VECTOR__TABLE for the V__SYSTEM 
driver. 


f. Top of RAM is the last address in memory. In a 256KB system this value is 3FFFFH while in a 
640KB system this value is 9FFFFH. The data region between Top of RAM and the base of 
HP__VECTOR__TABLE is not directly available to applications. In the base system this region 
is 4KB long. However, different system configurations may require that this region be 
lengthened. 
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B.3.1 Option ROM Data Segments 


An option ROM which does not have available on board RAM can get memory in the manner 
described above. However, the problem arises as to how the option ROM is to ‘remember’ the 
data segment if it doesn't have any RAM to save the segment in. This problem usually can be 
solved since most option ROMs are accessed through the software interrupt mechanism. The 
option ROM adapter simply directs Its entry point software interrupt vector to its EX-BIOS RAM 
data segment which in turn jumps to the option ROM's entry point. That is, 


80286 INT nn — EX-BIOS data segment —~ option ROM 


PUSH CS 
POP DS , Load option ROM DS 
JMP FAR ROM__ENTRY__POINT 


B.3.2 EX-BIOS Global Data Area 


The EX-BIOS global data area is shared between several EX-BIOS drivers. It contains temporary 
and permanent variables required by the EX-BIOS to function properly. Some of these variables 
can be modified by application programs. As with the STD-BIOS data area, care should be taken 
when modifying the EX-BIOS data area. 


The EX-BIOS global data area can be found by calling the V__SYSTEM driver, with the function 


F__INS__BASEHPVT. The EX-BIOS global data area segment will be returned in the DS register. 
Table B.12 defines the contents of this area. 
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Table B.12 
Global Data Area 


Type 
O00-013H Reserved Word 
14 T__SND__FLAG Byte 


Bit Definition 

7 ‘1° Click enabled 
6 ‘1’ Beep enabled 
5-0 Reserved 


T__SND__CLICK.__COUNT 


T__SND__CLICK__DURA 
T__SND__CLICK._ VOLUME 


T__SND__BEEP__CYCLE 


T__SND__BEEP__DURA 


T__SND__BEEP__COUNT 


Reserved 
T__STR__NEXT__INDEX 


20 and up Reserved* 
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Definition 


Sound driver status 


Contains the number of 
pending key clicks. Maximum 
of four. 

Contains the current tick 
duration scaler. 

Contains the current key click 
volume. 


Contains the current beep 
period in ten microsecond 
increments. 

Contains the current duration 
of the beep in 10 
microsecond increments. 
Contains the number of 
pending beep functions. 
Maximum of four. 


The next unused string index 
number. 


B.4 ROM BIOS Memory Map 


Table B.13 lists the compatible ROM entry points. The programmer is encouraged not to access 


these entry points directly. 


Table B.13 


Rom Entry Points 


Int Rom Entry 


2 FOOO:E2C3 
5 FOOO:FF54 
10 FOOO: F065 
11 FOOO: F84D 
12 FOOO: F841 


13 FOOO:EC59 
14 FOO0:E739 
15 FOO0: F859 
16 FOOO:E82E 


17 FOOO:EFD2 


18 FO00:4B86 
19 FOOO:E6F2 
1A FOOO: FE6E 
1B FOOO:FF53 
1C FOOO:FF53 


1D FOOO: FOA4 
1E 0000:0522 
1F FOO0 : 0000 


Type 
code 
code 
code 
code 
code 


code 
code 
code 
code 
code 


code 
code 
code 
code 
code 


data 


data 
data 


Function 


Nonmaskable interrupt 
Print screen 

Video 

Equipment check 
Memory size 


Diskette/hard disc 
Serial 

System functions 
Keyboard 

Printer 


Reserved 

Boot 

Time and date 
Keyboard break 
Timer tick 


Video parameter table 
Diskette parameter table 
Graphics character table 
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B.5 Product Identification 


Table B.14 


Product Identification Strings 


ROM version independent information 


OFOOO:O00F8H DB ‘H’ HP Vectra PC ID 
DB i 
DB OOH 
DB OOH 


ROM version dependent information 
OFOOO:QO0FCH DB Revision__Code_Secondary Secondary code revision 
DB 


Revision__Code__ Primary Primary code revision 
DB Date__Code__Year ROM Release year— 1960 
stored in BCD 
DB Date__Code__Week Week of the year stored in 
BCD 


Industry Standard PC ID 


QFOOO:FFFEH DB OFCH IBM-AT Compatible PC 
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APPENDIX C 


C. CMOS MEMORY LAYOUT AND 
REAL-TIME CLOCK 


The real-time clock chip contains 64 bytes of non-volatile memory. Values saved in this memory 
area are not destroyed when the system is powered off. Table C.1 defines the use of the CMOS 


memory area. 


Table C.1 


CMOS Memory and Real-time Clock 


CMOS Address 
OOH 


Application 


*RTC current second 
*RTC second alarm value 
*RTC current minute 
*RTC minute alarm value 
*RTC current hour 


*RTC hour alarm value 

*RTC current day of the week 
*RTC current day of the month 
*RTC current month 

*RTC current year 


*RTC status register A 
*RTC status register B 
*RTC status register C 
*RTC status register D 
*Diagnostic status byte 
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CMOS Address Application 


OFH *Shut down status byte 

10H Flexible disc drive type (A and B) 
11H Reserved 

12H Fixed disc type (C and D) 

13H Reserved 


Equipment byte 
Low base memory 
16H High base memory 
17H Extended memory size (low byte) 
18H Extended memory size (high byte) 


Reserved 

21-27H *Reserved 
28H *HP checksum for bytes 29, 2A, 2B, 2C 

29-2BH % *Reserved 

%* Reserved 


*Reserved 
2E-2FH *2-byte industry standard CMOS checksum for bytes 10H to 20H 
30H *Extended memory size (low byte, defined by POST) 
31H *Extended memory size (high byte) 
32H *Date century byte 


33H *Information flags 
34-3FH *Reserved 


Notes: 
*These bytes are not included in the industry standard CMOS checksum 
Yo These bytes are included in HP’s checksum 


C.1 Real-Time Clock/CMOS Access 


Port 70H and port 71H provide the interface to the real-time clock and CMOS memory controller. 
Port 70H is used to specify the byte address to read or write. Port 71H is used to pass the data. 
For example, to read the equipment byte, the programmer would write 14H to port 70H, then 
read the data byte from port 71H. A read or write to port 71H must always be preceeded by a 
write to port 70H. 


372 CMOS Memory Layout and Real-Time Clock 


~ 


C.2 Real-Time Clock (CMOS Address 00H-ODH) 


The real-time clock (RTC) chip maintains the current date and time, even when the system is 
powered off. Four registers are initialized by the SETUP program when the user sets the current 
date and time. These are detailed in tables C.2, C.3, C.4 and C.5. 


Table C.2 
CMOS__RTC__REGA (CMOS Address 0AH) 


Bit Data Definition 


The current date and time Is available to read 

The current date and time are not available to read because an 
update of these values Is in progress 

Time divider selection bits to indicate what time-base frequency Is 


being used. This field is set to 2H to indicate that a 32,768 hertz 
crystal is providing the time-base. 

Rate selection bits to specify output square wave frequency. This field 
is set to O6H to select a square wave frequency of 1.024K Hertz or a 
periodic interrupt rate of 976.562 microseconds. 


Table C.3 
CMOS__RTC_REGB (CMOS Address OBH) 


Bit Data Definition 


Update clock normally (default) 
Suspend clock updates 

Disable periodic interrupts (default) 
Enable periodic interrupts 

Disable alarm interrupts (default) 


Enable alarm interrupts 

Do not generate an interrupt when the current update cycle 
completes (default) 

Generate an interrupt each time a clock update completes 
Disable square wave output (default) 

Enable square wave output 


CMOS Memory Layout and Real-Time Clock 373 


Bit Data Definition 


Store date and time in BCD (Binary Coded Decimal) (default) 
Store date and time as binary integers 


Places hours byte in 12 hour mode 

Places hours byte in 24 hour mode (default) 
Disable daylight savings (default) 

Enable daylight savings 


Table C.4 
CMOS__RTC__REGC (CMOS Address OCH) 


Bit Value Definition 


No interrupts are currently asserted 

The RTC Is asserting an interrupt due to either the alarm, periodic 

interrupt, or update ended. 

No periodic interrupt has occurred since the last read of this bit. 

A periodic interrupt has occurred, read only and cleared by read. 

No alarm interrupt has occurred since the last read of this bit. 

An alarm interrupt has occurred, read only and cleared by read. 

te update ended interrupt has occurred since the last read of the 
It. 

An update ended interrupt has occurred, read only and cleared by 

read. 

Reserved 


Table C.5 
CMOS__RTC__REGD (CMOS Address 0DH) 


Bit Value Definition 


Power was lost to the RTC chip since the last read of this bit. 


The RTC chip has not lost power since the last read of this bit. Read 
only, set to 1 after read. 
Reserved 
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C.3. Diagnostic Status Byte (CMOS Address 0EH) 


This byte is set by the POST routine to flag errors detected during power on. The contents of this 
byte are detailed in table C.6. 


Table C.6 


CMOS__DIAGNOSTIC_STATUS (CMOS Address OEH) 


Bit Data Definition 


1 Power to RTC failed 

1 Bad industry standard CMOS checksum 
1 Configuration inconsistency 

1 Memory size does not match 

1 Hard disc failed initialization 

1 


Invalid CMOS 
-0 i Reserved 


7 
6 
5 
4 
3 
2 
1 


C.4 System Shutdown Byte (CMOS Address OFH) 


This byte is used by the system power-on sequence to determine what action is to be taken upon 
return from protected mode. The details of this byte are shown in table C.7. 
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Table C.7 
CMOS__SHUTDOWN__BYTE (CMOS Address OFH) 


Bit Value Definition “" 


Perform power-on reset sequence 
INT 19H (reboot) 
Flush keyboard and jump indirect via double word 40:67H 


Reserved 

Used by POST during test of protected mode RAM 
Used for INT 15H support (block move) 

Jump indirect via double word at 40:67H 

(same as values 0-3) 


C.5 Diskette Descriptor Byte (CMOS Address 10H) 


~ 
This byte is initialized by SETUP and indicates what types of flexible disc drives are installed. The 
details of this byte are shown in table C.8. 
Table C.8 
CMOS__FDC__TYPE (CMOS Address 10H) 
Bit Value Definition 
No drive installed as drive A 
360KB drive installed as drive A 
1.2MB drive installed as drive A 
No drive installed as drive B 
360KB drive installed as drive B 
1.2MB drive installed as drive B | ~ 
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C.6 CMOS Fixed Disc Type (CMOS Address 12H) 


CMOS__FIXED__DISC__ TYPE, (CMOS Address 12H), is reserved for the hard disc. 


C.7 Equipment Byte (CMOS Address 14H) 


This byte is used to initialize STD-BIOS RAM location 40:0010H. This is the value returned by 
the STD-BIOS interrupt INT 11 (get current equipment). The details of this byte are shown in table 
C9. 


Table C.9 
CMOS__EQ._ BYTE (CMOS Address 14H) 


Bit Value Definition 


One drive installed 
Two drives installed 
Primary display is 40 column color 


Primary display is 80 column color 

Primary display is 80 column monochrome 
Reserved 

80287 installed 

At least one flexible disc installed 


C.8 System Base RAM Size (CMOS Address 
15H— 16H) 


This value represents the amount of base (DOS addressable) memory installed in the system 
minus the amount of RAM used by the EX-BIOS data area. Three base memory configurations 
are valid: 
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0100H 256K of base memory installed 

O200H 512K of base memory installed 

O280H 640K of base memory installed 
The actual stored value will be adjusted to leave space for the EX-BIOS data area. For example, 
the value may be OOFCH instead of 0100H, indicating that there is 256K of base RAM installed 
but the EX-BIOS data area Is using 4K of it. 

CMOS__BASE__MEMORY__LSB (CMOS Address = 15H) 


CMOS__BASE__MEMORY__MSB (CMOS Address = 16H) 


C.9 System Extended Memory Size (CMOS Address 
17H— 18H) 


These values are initialized by the SETUP program to the user specified extended memory size 
from zero to 15Mb in 512Kb increments. For example: 


0200 512K of extended memory (0.5Mb) 
0400 1024K of extended memory (1.0Mb) 
0600 1536K of extended memory (1.5Mb) 
through 
3A00 14848K of extended memory (14.5Mb) 
3C00 15360K of extended memory (15.0Mb) 
Note that extended memory is memory above one megabyte. 
CMOS__EXT__MEMORY__LSB (CMOS Address = 17H) 


CMOS__EXT__MEMORY__MSB (CMOS Address = 18H) 
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C.10 EX-BIOS Checksum Byte (CMOS Address 28H) 


This byte contains the checksum which is used to verify the contents of the EX-BlIOS CMOS data 
locations. This checksum is computed each time one of these locations is modified using an EX- 
BIOS CMOS function. 

If bit 7 of byte 29 is 1 then 


CMOS__EX__BIOS__CRC = 
[29] + [2A] + [2B] + [2C] : 8 bit carryout 


If bit 7 of byte 29 is O then 


CMOS__EX__BIOS__CRC = 
[29] + [2A] + [2B] : 8 bit carryout 


C.11 EX-BIOS Reserved Bytes (CMOS Address 
29H—2CH) 


These bytes are reserved by EX-BIOS. They are included in the EX-BIOS checksum byte at CMOS 
address 28H. 


Table C.10 
CMOS__HPCONFIG (CMOS Address 29H) 


Bit Data Definition 


Do not Include byte 2C in checksum (default). Note: this bit is not 
reset during a <CTRL>-<Alt>-<Sys req> reset sequence 
Include byte 2C in checksum 


Select the first ROM video adapter as primary (default) 
Select the second ROM video adapter as primary 
Reserved 

Manufacturing test disabled 

Manufacturing test enabled 
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C.12 STD-BIOS Checksum Word (CMOS Address 
2EH-2FH) 


This word contains the checksum which is used to verify the contents of the STD-BIOS CMOS 
data locations. This checksum is computed each time one of these locations is modified using an 
EX-BIOS CMOS function. If the EX-BIOS Is not used for CMOS update then it is the programmer's 
responsibility to calculate and replace the STD-BIOS checksum. 


CMOS__STD__BIOS__CRC = 
[10]+ [11] +[12])+...+ [20] : 16 bit carryout 


C.13 Test Information Byte (CMOS Address 33H) 


Bit seven of this byte is initialized by the boot process to indicate that 640K of base memory Is 
installed. The details of this byte are shown in table C.11. 


Table C.11 
CMOS__TEST_INFO (CMOS Address 33H) 


Bit Data Definition 
1 128kb expansion RAM installed 


7 
6-0 — Reserved 
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APPENDIX D 


D. I/O PORT MAP 


Appendix D describes the I/O map of the system. Table D.1 lists the I/O map of all devices 
integrated in the System Processing Unit (SPU). Table D.2 lists the recommended 1/O port 
assignments for devices in adapter cards. Subsequent sections in the appendix describe the SPU 
built-in devices individually. I/O devices in adapter cards are described fully in the Vectra Technical 
Reference Manual, Volume I. 


Table D.1 
SPU I/O Map 
I/O Address Description 
000-01FH First DMA Controller (8237A) 
Q20-03FH Master Interrupt Controller (8259A) 
040-05FH Timer Controller (8254) 
O60H Keyboard Buffer Full port 
061H SPU Control port 
064H Keyboard Output Buffer Full (OBF) port 
O68H Keyboard Extended Command port 
O69H SVC Service Request read data port 
O6AH Keyboard Handshake port 


O6C-O6FH HP-HIL Controller ports 


RTC address / NMI disable port 
RTC data 


078H Hard Reset NMI enable port 
O7CH HP-Slave Interrupt Controller (8259A) port 0 
O7DH HP-Slave Interrupt Controller (8259A) port 1 


O80-09FH DMA Page Registers ports 
OAO-OBFH Industry Standard (STD) Slave Interrupt Controller (8259A) 
OCO-ODFH Second DMA Controller (8237A) 

OFOH Clear 80287 Coprocessor port 

OF1H Reset ” a a 


OF8-OFFH 80287 Math Coprocessor 
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Table D.2 
Adapter I/O Map 


I/O Address Description 


1FO-1F3H Hard Disc controller 
200-207H Game |/O adapter 
278-27FH Parallel port 2 
2E8-2EFH Serial port 3 
2F8-2FFH Serial port 2 


300-307H Prototype adapter card 


320-323H Reserved 

378-37FH Parallel port 1 

380-38FH SDLC, bisynch 2 

3A0-3AFH Bisynch 1 

3B0-3B7H Monochrome display adapter 
3BC-3BFH Monochrome display/Parallel adapter 


3D0-3DFH Color Graphics adapter 
3E8-3EFH Serial port 4 

3FO-3F7H Flexible Disc controller 
3F8-3FFH Serial port 1 


D.1 DMA Channel Controller 


The SPU supports seven DMA channels using two Intel 8237A DMA controllers in cascade mode. 
For each DMA channel there is a page register used to extend the addressing range of the 
channel to 16 MB. The only type of DMA transfer allowed is “I/O to memory”. No “I/O to I/O” or 
“memory to memory’ transfers are allowed due to the way the hardware is configured. For 
more detailed information on the 8237A DMA controllers see Intel’s The 8086 Family User’s 
Manual. 


Table D.3 summarizes how the DMA channels are allocated. 
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Table D.3 
DMA Channel Allocation 


First DMA controller (used for 8 bit transfers): 


channel 0 —Spare. 

channel 1 —Usually datacomm. 
channel 2 —Flexible disc I/O. 
channel 3 —Spare. 


Second DMA controller (used for 16 bit transfers): 


channel 4 —Cascade from first DMA controller. 
channel 5 —Spare. 
channel 6 —Spare. 
channel 7 —Spare. 


D.1.1 I/O Port Addresses for DMA Controllers 


Table D.4 shows the I/O port addresses for the page register and DMA controllers used when 
writing the DMA addresses. 
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Table D.4 
I/O Port Addresses and Address Lines 


DMA page register I/O Ports 


Channel 


O87H 
083H 
081H 
O82H 


/O port 


Address Lines 


A23-A16 
A23-A16 
A23-A16 
A23-A16 


Not connected 


O8BH 
O89H 
O8AH 
O8FH 


OOOH 
001H 


O02H 
O03H 
O04H 
OO5H 


QO6H 
OO7H 


OCOH 
OC2H 


OC4H 
OC6H 


OC8H 
OCAH 


OCCH 
OCEH 


A23-A17 
A23-A17 
A23-A17 
Used for RAM refresh 


address register (A15-A0) 
byte count register 


address register (A15-A0) 
byte count register 


address register (A15-A0) 
byte count register 


address register (A15-A0) 
byte count register 


address register (A16-A1) 
word count register 


address register (A16-A1) 
word count register 


address register (A16-A1) 
word count register 


address register (A16-A1) 
word count register 


byte transfers 


word transfers 


DMA Controller I/O Ports 
seme I/O port 


byte transfers 


word transfer 


Channel 4 (first channel on the second DMA controller) is used to cascade the first DMA 


controller and it must not be programmed for DMA transfers. 
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Channels 5 thru 7 are word-wide channels so the address lines used are Ai thru A23. 
Address line AO Is always forced to zero. The address register on these channels provides 
address lines A16 thru A1 and address lines A23 through A17 come from bits 7 through 1 
of the page register. Bit 0 of the page register is not used. Care should be taken in making 
sure that the counts and addresses are in words rather than bytes. 


Table D.5 lists I/O ports used for writing commands to the DMA controllers. 


Table D.5 


Controller Command I/O Ports 


Controller 
1 


1/O Write I/O Read 


ODOH Command Register Status Register 
OD2H Request Register illegal 

OD4H Single Mask Register illegal 

OD6H Mode Register illegal 

OD8H Clear Byte Pointer Flag illegal 

ODAH Master Clear Command Temporary Register 
ODCH Clear Mask Command illegal 

ODEH Multi-Mask Register illegal 


D.2 8259A Interrupt Controllers 


The system has three 8259A interrupt controllers. They are arranged as a master interrupt 
controller and two slaves that are cascaded through the master. Table D.6 shows the I/O ports 
for these interrupt controllers and how they are cascaded. 
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Table D.6 
8259A Controller I/O Ports 


Register Name Master HP-Slave STD-Slave 


Command Register 20H 7CH OAOH 
Interrupt Mask Register 21H 7DH OA1H 


Table D.7 shows how the master and slave controllers are connected. The Interrupt Requests 
(IRQ) are numbered sequentially starting with the Master 8259 controller and followed by the 
industry standard (1S) Slave and HP-Slave. 


Table D.7 
8259A Master to Slave Connections. 


Master's IRQ Interrupt Request Description 


IRQO (08H) Timer 
IRQ1(Q9H) <——L[ HP-Slave IRQ ] Keyboard 


IRQ2 (OAH) 
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TRQ16 (68H) 
TRQ1/7 (69H) 
TRQ18(6AH) 


TRQ19 (6BH) 
TRQ20 (6CH) 
TRQ21 (6DH) 
TRQ22 (6EH) 


TRQ23 (6FH) 


<—[ STD-Slave IRQ ] 


TRQ08 (70H) 
TRQ09 (71H) 
TRQ10(72H) 
TRQ11 (73H) 


IRQ12 (74H) 
TRQ13 (75H) 
TRQ14 (76H) 
TRQ15 (77H) 


8041 
Keyboard OBF 
Reserved 


Reserved 
HP-HIL Controller 
Reserved 
Reserved 
Reserved 


Reserved 

Real Time Clock 
SW Redirected 
Reserved 
Reserved 


Reserved 
80287 Coprocessor 
Hard Disc 
Reserved 


Master's IRQ Interrupt Request Description 


IRQ3 COBH) Serial Port 1 
IRQ4 (OCH) Serial Port O 


IRQ5 (ODH) Printer Port 1 
IRQ6 (OEH) Diskette 
IRQ? COFH) Printer Port 0 


Note: The numbers in parentheses are the interrupt vector numbers generated by the IRQs. 


The following example shows how the 8259A controllers are programmed on initialization: 


CLI ; Disable interrupts 
PROGRAM__MASTER: 
MOV AL, 17H ,ICW1: Initialization Command 
OUT 20H,AL 
JMP $+2 
MOV AL,O8H / Interrupt Vector Base at O8H 
OUT 21H,AL 
JMP $+2 
MOV ~~ AL,O6H ; Define master with two slaves 
OUT 21H,AL , one at IRQ7 and one at IRQ2 
JMP $+2 
MOV AL,OTH , 8086/88 Mode 
OUT 21H AL 
JMP $+2 
PROGRAM__HP__SLAVE: 
MOV AL, 17H ,ICW1: Initialization Command 
OUT 7CH,AL 
JMP $+2 
MOV AL,68H , Interrupt Vector Base at 68H 
OUT 7DH,AL 
IMP $+2 
MOV AL,OIH ; Slave ID number 
OUT 7DH,AL 
JMP $+2 
MOV  AL,OTH , 8086/88 Mode 
OUT 7DH,AL 
JMP $+2 
MOV AL,68H ; Place HP slave on special 
OUT 7CH ; mask mode. 
JMP $+2 
PROGRAM__STD__SLAVE: : 
MOV AL, 17H ,ICW1: Initialization Command 
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OUT OAOH,AL 

JMP $+2 

Mov AL, 70H ; Interrupt Vector Base at 70H 
OUT OA1H,AL 

JMP $+2 

MOV AL,O2H ; Slave [D number 
OUT OA1H,AL 

JMP $+2 

MOV AL,OTH , 8086/88 Mode 
OUT OA1TH,AL 

IMP $+2 

STI ; Reenable interrupts 


The following example shows how an interrupt generated from the HP-Slave is serviced. This 
provides an example of what commands to send the 8259 controllers to handle an IRQ request. 
See Section 4 for more details. 


: Interrupt handler example for handling an IRQ16 which is an 8041 
; keyboard controller service request: 


INTERRUPT__ HANDLER: 


PUSH AX ; Save registers 
IN AL,7DH ;, Get enable mask from HP-Slave 
JMP $+2 
OR AL,O1H ; disable IRQ176 interrupt 
OUT 7DH,AL 
JMP $+2 
MOV AL,20H , Send an EOI to master 8259 
OUT 20OH,AL , so that other interrupts can 
JMP $+2 ; get thru 

, 8041 Service processing here 
IN AL,7DH , Get enable mask from HP-Slave 
JMP $+2 
AND AL,OFEH ; Enable IRQ16 again 
OUT 7DH,AL 
JMP $+2 
MOV AL,60H ; Send the HP-Slave a specific 
OUT 7CH,AL ; EO! command. 
JMP $+2 
POP AX ; Restore registers 
IRET 
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D.3 8254 Timer Controller (I/O Ports 40H 
through 43H) 


The system contains an Intel Programmable Interval Timer 8254. The timer controller consists of 
three separate timer channels; timer channels 0, 1 and 2. Channel 0 provides the BIOS with a 
programmable time interval. Channel 1 provides the memory refresh signal of the dynamic RAMs 
in the system. Channel 2 generates a fixed frequency envelope to the sound generation circuit. 
WARNING! 
Timer channel 1 should not be used. Writing to this channel may cause loss of data in 
system memory. 


The timer chip interfaces to the 80286 via 4 I/O ports: 


I/O Port Function 


O40H Counter data for timer 0. 
041H Counter data for timer 1. 
042H Counter data for timer 2. 
043H The control register for all three timers. 


See Intel's 8086 Family User’s Manual for more details of the 8254 timer controller. 


D.4 Keyboard Data Buffer (60H) 


The keyboard data buffer is read by the 80286 when the keyboard asserts the OBF interrupt. The 
OBF signal is automatically cleared when the data buffer is read. See Section 5 for more 
information about the keyboard data buffer. 


D.5 SPU Control Port (61H) 


The SPU Control Port (61H) is a bidirectional buffer which latches an assortment of unrelated 
signals. Table D.8 describes the bit values contained in this buffer. 
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Table D.8 
PORT 61H Bit Values 


When 80286 reads port 61H: 


Bit Data Definition 


1 Parity error in on-board system ram 
1 I/O channel check error has occurred 

Output from timer channel 2 

Refresh detect; toggles once per refresh cycle 

Status of I/O channel check NMI latch (See Fig D.2) 
1 Disabled. 
0 Enabled 

Status of SPU RAM parity error latch (See Fig D.2) 
1 Disabled 
0 Enabled 
] 
] 


WAhRUONS 


NO 


Speaker data from timer channel 2 is enabled to drive speaker circuit. 
Gate to timer channel 2 is enabled 


When 80286 writes port 61H: 


Bit Data Description _ 


7-4 Not used 

Disable and clear I/O channel check. 
Disable and clear on-board parity NMI 
Enable the data from timer channel 2 to drive speaker circuit. 
Enable gate to timer channel 2. (speaker data) 


O — NW 
— — — 2» 


D.6 Speaker Control 


Figure D.1 shows the relationship of the timer channel 2 and the rest of the speaker circuit. 
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Speaker Control Circuit 


1/O port 61H, bit 0 


1.190 Mhz | and 


to speaker 
via driver 
circuits 


I/O port 61H, bit 1 


Figure D.1 


The sound related EX-BIOS functions are the recommended method of accessing the speaker 
functions (see Section 9). 


D.7 Keyboard I/O Ports 


Keyboard Command Port (64H): Used to write commands to the 8041 keyboard controller. 


Keyboard Extended Command Port (68H): provides a data/command path to the 8041 not 
conflicting with the industry standard I/O Ports 60H and 64H. 


KBD Request Port (69H): Allows communications between the 8041 and the EX-BIOS service 
request (SVC) routines. 


Keyboard Handshake (6AH): The single bit write only port provides a mechanism for the 8041 
keyboard controller to indicate the last service request (SVC) has been handled. 


HP-HIL Controller (6CH thru 6FH): This set of I/O Ports provides the communication mechanism to 
the HP-HIL controller. 


D.8 Real Time Clock Ports 


Real Time Clock and CMOS RAM ports 70H and 71H provide the interface to the MC146818 real 
time clock (RTC). See Appendix C for further details. 
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D.9 Hard Reset Enable Port 


Hard Reset Enable Register (Port 78H): This write only port enables the hard reset line from the 
HP-HIL controller. Table D.9 shows the bit definitions for this port. 


Table D.9 


Hard Reset Enable Register 


Bit Data Description 
Enable hard reset from HP-HIL controller chip. 


Disable and clear hard reset from HP-HIL controller chip. 
Reserved. 


D.10 NMI Sources and Involved I/O Ports 


The non-maskable interrupt (NMI) of the 80286 is attached to circuitry which allows multiple 
sources to cause an NMI. Each of these sources can be disabled individually as well as collectively. 


Figure D.2 is a block diagram of the NMI circuit. 
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NMI Circuit 


(Parity Enable) 


Port 61H NQ 
bit 2 latch 
Q 
and 
cir Q 
latch 
Parity 
Check 
Line 


(I/O Channel Check Enable) 


Port 61H NQ 
bit 3 latch 
Q 
=> re 
NMI 
clr 
latch 
1/O Q 
Channel 
Check 


(Hard Reset Enable) 


Port 78H NQ 
bit 7 latch 
Q 
clr 
latch 
Hard Q 
Reset 


From Keyboard 
(NMI Enable) 


latch 
Port 70H 
bit 7 ~ 
Figure D.2 
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APPENDIX E 


E. SYSTEM EQUATE FILE 


This appendix contains the Macro Assembler (MASM) listing of the system equate file, 
EQUATES.ASM. 


Equates are assembly language (MASM) directives. The term equate as used here includes the 
MASM directives: EQU, ‘=, STRUC, RECORD, and MACRO. They allow the programmer to 
assign ASCII strings (names) to numeric constants, data structures, data records and macros. The 
name can then be used in programs to define data structures, code structures, or record 
structures. When the program is assembled, MASM substitutes the value associated with the 
name for every occurance of the name in the source code. 


The MASM directive ‘INCLUDE’ is used by programs to define constants, data structures or code 
structures commonly used by different programs. When a particular equate or group of equates 
is needed in a program, the programmer does not have to either define a new equate name for 
the variable or type it into the program. The programmer can use the ‘INCLUDE’ statement to 
define the equate. At assembly time the INCLUDE directive causes the assembler to read a 
specified file and process it as if its contents were actually in the orignal source code file. See the 
HP Vectra MS-DOS Macro Assembler manual for more information on include files. 


E.1 The Equate File 


The equate file supports programmer's access to both the STD-BIOS and EX-BIOS. Support is 
provided for software interrupt numbers, interrupt function and subfunction codes, and data 
structures associated with the various functions. Commonly used MACROS are also defined. 
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Equates File 


Paae 59,132 
.286¢ 


Whe 


NAME EQUATES 
EOI OOOO IOI OOOO OOOO IDOI OSORIO IOC IO IO III IOI III 
; This file contains equates, data structures and definitions needed to 
access both the Standard BIOS (STD-BIOS) and the Extended BIOS (EX-BIOS) 
of Vectra using MASM 3.0. Depending on what part of the BIOS you are 


accessing you might not need all the equates The equates are organized 
as follows: 


> © 80286 Support Macros. 
; © EX-BIOS Equates. 
: 1) Generic Structures and equates used by all drivers. 
‘ 2) Equates for Vector Addresses 
; 3} Function and Subfunction Equates common to all drivers 
4) Function and Subfunction Equates individual to drivers. These 
are ordered by vector number 
MS-DOS Macros and Equates 
Industry Standard TO-BIOS) Interrupt numbers and function equates 
Industry Standard (STO-BIOS) Data Area 
Bit definitions for Industry Standard (STD-BIOS) data area entries 


ooo°o 


The programmer can extract only those equates that he needs to create 
a tailored equate file. 


EIKO OOOO OSD EID IOI IOS ENIAC IIIA IISA IOI IK 
page 


OOOO OOOO IO OOOO OOOO IO IO OO IIR IOI GIIOI IOI IOK 
; 80286 Support macros and equates 
OOOO OOOO OOOO OOOO IO OOO IO IO IO IO IORI IK IOI IOK 
OOO OOOO OOOO OO IO IOI IO OOOO IO IO OIRO IORI IOIOI 
The following macro is used to compensate for a bug in the 80286 
hardware interrupt system. During a normal POPF instruction 
; ee interrupts are always enabled regardless of the state of 
; the interrupt enable flag prior to the pop or after the pop. 
USO SIRES OOOO OGG OI QI QOI IG OI OIG OOO IGOR II OO IOI IOI ICOK 


PWWWWWWWWWUWRPRARIAD MPRDRPID PO & ee me re ee ee OU 
COWODONAMN EWN THOMOND ARUN OWOONAMAWNAO 


POPPF macro 

jmp $+3 

lret 

push cs 
41 call $-2 
a endm 
44 AOI COIR IODA OOOO IO IOI OIRO IOI IGOR 
45 , EX-BIOS support macros and equates. 
is OOOO IO OOOO OOOO OOOO ORO IO IO IOIOIOR IOI I IOI IIOK IO ROK 
48 , Equates for EX-BIOS interrupt number and vector address. 
oA e 0OO6F HP ENTRY equ 6FH 
51 
52 OOOO OOOO OOOO OOO OOOO OOOO OOOO IO III IOK 
53 ; SYSCALL [vector address] 
54 OOOO OOO IO OOO OOO IOI OOOO IAG IOOIO OIC IOOIOI IOI NOK 
55 syscall macro vector 
56 Yt nb <vector> 
57 mov bp ,vector 
58 endif 
59 int HP_ENTRY 
a endm 
62 AAO OOO OO IOI OOOO IOK NORIO IIOK 
63 , HP_VECTOR TABLE Entry ; 
64 AIO OA ICO IO IOIDIOIOIDIOIOIA SOOO OOOIOIOIOOIOIOOR IOI DK 
65 HP TABLE ENTRY struc ,41,2,3> 
66 0000 0000 HP ENTRY IP dw 0 
67 0002 0000 HP_ ENTRY CS dw 0 
68 0004 0000 HP_ENTRY DS dw 0 
69 0006 HP_TABLE_ENTRY ands 
70 age 
71 FTE TTT TTT TTT TTT TTTTTT TREE OTT TTT TET TT TERETE 
72 ; Structure of Data Header for HP's vectors. 
73 , KKXKKKEKAKKAKAKA AK AA AK AKA KAA EKA AKA KAKA AK AKAAKAKKAKKAK AKA AKA AKKAAKAKAAAKAKAKAKAK KKK 
74 HP SHEADER STRuUC ;<1,2,3,4,5.6,7,8,9,0> 
75 0000 0000 DH ATR dw 0 , Attribute 
76 0002 0000 DH NAME INDEX dw 0 ; Name index of driver. 
77 0004 0000 DH_V_DEFAULT dw 0 . Driver vector position in HPtable 
78 0006 0000 DH_P_CLASS dw 0 ; Parent class 
79 0008 0000 DH C CLASS dw 0 > Child class 
80 000A 0000 DH_V_ PARENT dw 0 Vector used when the driver cannot handle 
81 ~ an F_ISR function call 
82 000C 0000 DH_V_CHILD dw 0 Vector used when the driver cannot handle 
83 ners ; @ regular function call 
84 OO0E 00 DH MAJOR db 0 ; Driver's major address if any. 
85 OOOF 00 DH MINOR db 0 ; Driver's minor address if any. 
86 0010 HP SHEADER ENDS 
87 
88 ; KEKKKKEKKKAKAKAAAAAKAKAKAAK KA AKAAKKAKAAAKAAKAKAKAKAKEKKAKKKKAKAKAAKKAKAKAKKKAKAKAKKKKKKK 
89 : DH ATR bit record 
90 OOOO OOOO OOO OOOO OOO IA OOOO OOO III 
91 =» 8000 ATR_HP equ 1000000000000000B . 1- The Rest of header is valid 
82 = 4000 ATR_DEVCFG equ 0100000000000000B ; 1l- Present in DEVCONFG 
93 = 2000 ATR_ISR equ 0010000000000000B . 1- Replace My ISR (Child) 
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1000 


Equates File (continued) 


" ATR_ENTRY equ 00010000000000008 l- Replace My ENTRY (Parent } 
= 0000 ATR RSVD equ 0000000000000000B 0 - Available on allocation from HP 
« 0200 ATR FREE equ 0000001000000000B 1 Available Vector 
= 0400 ATR _SRVC equ 0000010000000000B 2 Service Vector 
98 = 0600 ATR_ LOG equ 0000011000000000B 3 ical Device Start DEVCONFG CHA 
99 = 0800 ATR INO equ 0000100000000000B 4 Filter, show driver (options) 
100 = 0A00 ATR BOT equ 0000101000000000B 5 End of Chain 
101 = 0C00 ATR_INP equ 0000110000000000B 6 Mappabdle input driver 
102 * 0£00 ATR _TYPE7 equ 0000111000000000B8 7 Available 
103 = 0E00 ATR_ TYPE MASK equ 0000111000000000B 
104 zs 0100 ATR STRING equ 0000000100000000B 
105 = 0080 ATR MAP CALL equ 0000000010000000B 
106 = 0060 ATR _SUBADD equ 0000000001100000B8 
107 x 0000 ATR _NOADOR equ 00000000000000008 
108 = 0020 ATR_ MAJOR equ 0000000000100000B 
109 = 0040 ATR_MINOR equ 0000000001000000B 
110 = 0060 ATR _MID equ 0000000001100000B 
111 = 0010 ATR PSHARE equ 00000000000100008 
112 = 0008 ATR CSHARE equ 0000000000001000B 
113 = 0004 ATR _ROM equ 00000000000001008 
114 * 0002 ATR YIELD equ 00000000000000108B 
115 = 0001 ATR_0O equ 00000000000000018 
116 page 
117 AOR OOOO OOOO OOOO OO IO IO OO OO OR IO IO IOI NOK IK 
118 DH Class 
119 JOTI I TT TLE T TT AT ATTA ITA TTA AI ATI IIIA IAAT IAAI IAI IIA 
120 = 8000 CL_KBDFC equ 100000000000000CB . lL - HP Softkey Transaltor 
121 = 4000 CL_KBD equ 01000000000000008B 1 Keyboard 
122 = 2000 CL_CCP equ 0010000000000000B 1 - Cursor Control pad 
123 = 1000 CL_CON equ 0001000000000000B 1 - Console Device 
124 = 0800 CL_BYTE equ 0000100000000000B 1 - PRN device 
125 =» 0400 CL COMM equ 0000010000000000B 1 - COMM device 
126 = 0200 CL_INTERFACE equ 0000001000000000B Ll - interface. HP-HIL. HPIB 
127 = 0100 CL FILT equ 0000000100000000B8 1 - charachter filter 
128 = 0080 CL_BLK equ 0000000010000000B 1 - block device 
129 z= 0040 Cl _ BOOT equ 00000000010000008 1 - boot block device 
130 = 0020 CL_LGID equ 0000000000100000B 1 - logical physical gid 
131 eg ccp to gid translator 
132 = 0010 CL_PGID equ 0000000000010000B 1 - physical gid 
133 = 0008 CL_GID equ 00000000000010008 1 - any es hics input device 
134 = 0004 CL PTS equ 00000000000001008B 1 - physic touch screen 
135 = 0002 CL_ASCII equ 0000000000000010B 1 - ascil input device 
136 » 0001 CL_EXTEND equ 00000000000000018 0 set of classes above 
137 1 - alternate class set 
138 = FFFF CL_ALL equ 1111111111111111B Member of all classes 
139 = 0000 CL NULL equ 0000000000000000B Member No Classes 
140 
14) S22 22% > 2 2 2% oo >So 9 2 > 90099 > 0099 9 9 9099000999 990000 090009999 990000005 0000508 0: 
142 ; Vector Addresses 
143 OOOO OOOO ICO OOOO OOOO OOO KOO OOOO OOK OK 
144 » 0000 V_SCOPY equ 0000H , Copyright Notice 
145 = 0006 V_DOLITTLE equ 0006H . Nop Routine 
146 » 000C V_PNULL equ 000CH . No Device 
147 » 0012 V_SYSTEM equ 0012H ; System Intrinsics 
148 ® OOIE V_ $8259 equ OO1EH . 8259 Interface 
149 = 002A V_SINPUT equ 002AH . Input Inquire routines 
150 = 0036 V_QWERTY equ 0036H . Qwerty KBD Translator 
151 = 003C V_SOFTKEY equ 003CH HP f1-f8 Translator 
152 = 0042 V_FUNCTION equ 0042H » IBM F1-F10 Translator 
153 = 0048 V_NUMPAD equ 0048H ; Numeric Pad Translator 
154 = O04E V_CCP equ OO04EH , CCP Translator Driver 
155 ® 0054 V_SVIDEO equ 0054H Video Intrinsics 
156 » 0O5SA VoCVENS. equ OOSAH Common cursor control] funcs. 
157 » 0060 V_EVENT_ TOUCH equ 0060H Touch Event Intercept 
158 = 0066 V_EVENT TABLET equ 0066H Tablet Event Intercept 
159 = 006C V_EVENT POINTER equ OO6CH Pointer Event Intercept 
160 = 008A V_CCPCUR equ 008AH CCP to Cursor Always Filter (Default) 
161 = 0090 V_RAW equ 0090H CCP+Softkey RAW Mode Filter 
162 = 0096 V_CCPNUM equ 0096H CCP to Numeric Pad Filter 
163 » 009C V_OFF equ 009CH CCP+Softkey Off Filter 
164 s 00A2 eee equ 00A2H . CCP to GID Filter ( Not Implemented) 
165 ® 00A8 V_SKEY2FKEY equ OOA8H : eeu: (f1l-f8) to Function 
166 1-F8) Filter (Default) 
167 =» OOAE V_ 8041 equ OOAEH - 804 trteriace 
168 2 0084 V_PGID_CCP equ OOB4H , Graphic to CCP Filter 
169 = 0OBA V_LTABLET equ OOBAH . Tablet driver 
170 = 00C0 V LPOINTER equ 0OCOH : Pointer driver 
171 = 00C6 V_LTOUCH equ 0OC6H Touch driver 
172 = 00CC V_LHPMOUSE equ 00CCH Microsoft/Mouse System's 
173 : Compatible Oriver 
174 = 0108 V_LNULL equ 0108H . No Driver 
175 » 0114 V_HPHIL equ 0114H . HP-HIL Driver 
176 
177 KKK KKK KKK KKK KKK KKK KK KKK KEK KKK KKK KKK KKK KKK KKK KEK KKK RRR KKK KKK KKK 
178 ; Common Function Codes for HP Routines 
179 OOOO OOOO OOOO OKO 
180 = 0000 F_ISR equ 00HXK2 . Interrupt service call 
181 z= 0002 F_ SYSTEM equ O1HX2 . System func. call, 
182 Subfunction required 
183 = 0004 F_ IO CONTROL equ 02HxX2 Device/Driver Dependent 
184 Functions 
185 = 0006 F PUT BYTE equ 03HxK2 Write one byte of data. 
186 Byte is in AL 
187 «= 0008 F GET BYTE equ 04HxK2 Read a byte of data: 
188 Byte returned in AL 
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Equates File (continued) 


vou 
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PO RO AO AD AO AO AO AD PO AD AD AO AD AO AD AO 89 AO AO AD AY BO A AO DD BO AO BAD AO AO AO AO AO DD DD ADP —AD be bP be be ee 
OC) 0) 09 0 WD WD C2 OI AJ AD ROP AOD AD PO DD be be Be be be me eh OO OD DDO COOCOWOWOWOWODOWOWWOWD 


NH OD ONOMUNE WAH OW ONO aWNH OW ONMDURUN HOD ONDTAWN HOOD HMA WN+FOODHAUD 


AOR PO ROA PO DO AAD AD AD PO AOD PO AD AD PO AD PO DAD DAD AD PO AO 00 PO PO PI PO PO POA DO PPO PO PO PO AAD POD AD 
00 00 C8 NNN END ODDMAIMOANAHOMOMMUWUNNUNUIUTUUT hb bP hhLhAaALLLAaAWUW 
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Q00A 
000C 


OOOE 
0010 


0000 
0002 


= 0004 


0006 
0008 
000A 


000Cc 
OOOE 
0010 
0012 
0014 
0016 


0000 
0002 


PODDCCODODCOCOOCOOCOO 
loko Rokovorololocolololyoyolere) 
WWWW WW WWM DID ee be 
MOPAMRaNOYP AaANOMAMSA 


. 


F PUT BUFFER equ 05SHXK2 ; Write a buffer of data, 

: ES ,DI pointer, CX count 
F_ GET BUFFER equ O6HX2 ; Read a buffer if data, 

; ES,DI pointer, CX count 
F PUT WORD equ O7HK2 , Write word of data, DX data 
F GET WORD equ 0 8HxX2 , Read word of data, DX data 
F PUT BLOCK equ F_ PUT BUFFER ‘used for disk applications 
F_ GET BLOCK equ F GET_BUFFER 


OOOO OOOO OOOO OOOO OOOO OOK 
- Common Subfunction codes of the F SYSTEM Function. 
OOOO” OOOO OOOO OOOO OOOO” ROO IOI OIOI IKK 00801 KK, 


SF_INIT equ OOHK2 ‘Initialize command 
SF START equ O1LHK2 Seedy Gd Init--initialize dependent 
; upon other drivers/data structures 
SF REPORT STATE equ O2HxX2 ‘Reports state of driver 
SF VERSION DESC equ O3HXK2 ‘Report version and option describe 
> record 
SF DEF _ATTR equ 04HX2 ‘Reports default Configuration 
: (Baud Rate) 
SF _ GET_ATTR equ OSHX2 ‘Reports Current Configuration 
ES,DI pointer 
SF SET ATTR equ O6HX2 ‘Sets Next Configuration ES ,DI, CX 
SF_ OPEN equ 07HX2 ;Reserve Driver for exclusive access 
SF CLOSE equ 08HX2 ‘Release “ from 
SF TIMEOUT equ O09HX2 ;Notify Driver Timeout Occurred 
SF INTERVAL equ OAHK2 eee Driver Interval Occurred 
SF TEST equ OBHxX2 :Test Function 


OOOO” OOOO IO OOO IO OO IO IO OO IOI IOI IOIOK IORI KKK 

. Common Subfunction Codes for the F IO CONTROL function. 

OOOO OOOO OOOO OO HOOK IOK 
SF_LOCK equ OOHK2 ; Lock Device for exclusive access 

SF UNLOCK equ O1LHX2 ; Unlock Device for exclusivce access 


ee eT ECE ET Tee Teer ere Tree nn eee eer nn Tm 


HP Routines Return Status Sucessful codes are positive and failure 
are negative 


IDOE SOGOASOOISSSIIA A OIOO OOOO OOOO AICO III 


RS BREAK equ 00CH Break -~- IFC 

RS DATA NREADY equ 00OAH ; RS232 Data Not pice Amn Operation 

RS OVERRUN equ 008H ; RS232 Port Data Overrun Retry Operation 
RS DONE equ 006H ; indicates all done notin child 

RS_ NOT SERVICED equ 004H ; indicates a chained ISR--not handled 


RS _ UNSUPPORTED equ 002H ; indicates function is NOPed/not valid 
; for this driver 


RS SUCCESSFUL equ 000H ; indicates executed just fine 
OOOO OOOO OOO OOOO OOOO ORO IOI OR IFA OIIOI IOI IOI OK 


RS_ FAIL equ OFEH ; To be used with hardware failure 
RS_ TIMEOUT equ OFCH , to indicate remote device timeout 
RS_BAD_ PARAMETER equ OF AH , to indicate a bad parameter 
RS BUSY equ OF 8H ; to indicate driver/device is busy 
Ree VECTOR equ OF6H , out of hp_VT vectors 

RS OFFLINE equ OF 4H ; device is offline 
RS _OUT_OF PAPER equ OF 2H ; out of paper on printer device 
RS_ PARITY equ OFOH ; parity error in transmission 
RS FRAME equ OEEH ; framing error 


page 

Good addoiipapagooaa|dodonobiipbiipapaonoddtobonodnitoipopdopopiininanaonoioion 
; Function Number Equates for the EX-BIOS routines and its Data Structures. 

ese e eee TTS SCT SST CST SCOTS CCST SCE SSS CESS SCT SC CCS S CTS ECTS CTS STE S TOS eT CTS TTT ST 


 KKKKKKKKAKRKAKAAKAKAK KKK KAKA KKK AKAKKRKAKKAKKKKAKAKKAKKKAAKKKKAKKKKAKKAKKAKKKKAK 
V_SYSTEM (0012H) function codes. 

IDO OOOO OOOO OO OOOO SA OIOHIO GNI AG IO aIO SOOO AOA I AOOIO IOI 
F_ISR and F_SYSTEM are functions common to all drivers. 


F_INS BASEHPVT equ 0004H 
FINS XCHGFIX equ 0006H 
F_INS XCHGRSVD equ 0008H 
FINS XCHGFREE equ 0O0AH 
F INS FIXOWNDS equ 000CH 
F_INS FIXGETDS equ OOO0EH 
F_INS FIXGLBDS equ 0010H 
F_INS FREEOWNDS equ 0012H 
F_INS FREEGETDS equ 0014H 
F_INS FREEGLBDOS equ 0016H 
F_INS FIND equ 0018H 
F RAM GET equ OO1EH 
F RAM RET equ 0020H 
F CMOS _GET equ 0022H 
F CMOS RET equ 0024H 
F YIELD equ 002AH 
F_SND_CLICK_ENABLE equ 0030H 
F_SND_CLICK DISABLE equ 0032H 
F_SND_CLICK equ 0034H 
F_SNO_BEEP_ ENABLE equ 0036H 
pace see eae DISABLE equ 0038H 
F_SNO_ BEEP equ 003AH 
F_SND_SET_ BEEP equ 003CH 
F SND TONE equ OO03EH 


Equates File (continued) 


283 = 0040 F_STR_GET FREE INDEX equ 0040H 
284 » 0042 F_STR_ DEL BUCKET equ 0042H 
285 s 0044 F STR PUT BUCKET equ 0044H 
286 » 0046 F STR GET STRING equ 0046H 
287 = 0048 F STR GET_INDEX equ 0048H 
288 ache 
289 KEKE KKK KK KAK AK EKA AK KAKA KKK KE AK KKK KKK ARK KK KKK KKK KKK KEKE 
290 String Bucket Header This structure 1s useful 1f using the 
291 : Poe ceeud V_ SYSTEM functions. F STR DEL BUCKET and F_STR PUT BUCKET. 
292 OOOO OO OOO OOO OO IO I IOIOIOK IO I iOK 9G 110K 90K 2 0K 
293 STR HEADER STRUC 
294 0000 77777777 STR NXT_HDR dd (?) 
295 0004 777? STR UPPER BOUND dw {?) 
296 0006 ?77? STR LOWER BOUND dw (?) 
297 0008 77777777 STR LIST PTR dd (?) 
298 000C 777? STR SEGMENT dw (?) 
oe OOOE STR HEADER ENDS 
00 
301 , KKKKKKAKKKKKKK KAKA KKKAARAKAKKKAKKAKKKKAKKKEKKKKAKKKKKKAKKKAKAKAKEKKAKKAKAKKKKAKKX 
302 . V_SYSTEM Global Data Segment 
303 OSS 225985 > 099959959 055955959 0095095599599 5559955 9955590599995 508 5 999 8 | 
304 HP GLB HEADER STRUC 
305 0000 ?77? T_HP_HEADER dw ue 
306 0002 06 [ T_USED_AND_RESERVED dw dup (7) 
307 2272? 
308 J 
309 
310 OOOE 777? T_HP_LAST DOS dw (?) 
311 0010 777? T_HP_ MAX BS dw (7?) 
312 0012 7777 T_HP_ NXT _VCTR dw ?) 
313 0014 ?? T_SNOB_FLAG db ?) 
314 0015 7? T_SND_CLICK_COUNT db ?) 
315 0016 ?? T SND CLICK DURA db 7) 
316 0017 ?? T_SND_CLICK VOLUME db {>} 
317 0018 ?77? T SNO_BEEP CYCLE dw (7) ; 
318 O0O1A 777? T_SND_BEEP DURA dw (?) 
319 0o1Cc 7? T_SND_BEEP_ COUNT db (7?) 
320 001D 7? db ?) l reserved byte for volume 
321 QOO1E 7777 T STR NEXT INDEX dw 7) 
322 0020 77777777 T STR ROOT dd ?) 
aoa 0024 OE [ Pe T_STR_VCT_HDR db size STR HEADER dup (7?) ; Area vector'’s name and 
325 ) 
326 
ae 0032 OE [ a5 T_STR_MSG_ HOR db size STR HEADER dup (7) ROM message strings 
329 J 
330 
331 0040 ?? T 8259 FLAQS db (?) 
os 0041 lF [ ss db 31 dup (7) reserve 2 paragraph 
334 } 
335 
336 0060 HP GLB HEADER ENDS 
337 page 
338 KAKA KKK KKK KK KKK KAKA KKK KAKA KKK KKK KAA KK KKK AKA K KKK AKA KAKA AAKKA KKK 
339 , V_$8259 interrupt controller support 
340 KKK KKK RK KKK KKK KKK A KKK EKA KAKA KK KKK KAA KKK KKK EKA KK KAKA KAKA AE 
341 . F_ISR and F_SYSTEM are functions common to all drivers. 
342 
343 
344 Driver specific F_I0 CONTROL subfunctions. 
345 
346 = 0000 SF ENABLE SVC equ 00H unmask svc/8041 interrupt 
347 a 0002 SF DISABLE SVC equ 02H mask svc/8041 interrupt 
348 = 0004 SF ENABLE KBD equ 04H - unmask keyboard INT 9 interrupt 
349 = 0006 SF DISABLE KBD equ 06H » mask keyboard INT 9 interrupt 
350 = 0008 SF _ ENABLE HPHIL equ 08H - unmask HP-HIL interrupt 
351 » QO0A SF DISABLE _HPHIL equ OAH mask HP-HIL interrupt 
352 
353 OOOO Om OOOO IO IOI OI I IOI RIO OO OIRO OR FORK 
354 » V_SINPUT Function and subfunction codes 
355 IDO IOI IORI ORK SOR ORO I OOK RO OK OK OOK 
ce . F_ISR and F_SYSTEM are functions common to all drivers. 
aoe ; Driver Specific F_IO_ CONTROL subfunctions. 
360 x 0000 SF_ DEF _ LINKS equ OOOOH ; Sets default cofiguration 
361 » 0002 SF GET LINKS equ 0002H ; Reports current configuration 
oe = 0004 SF SET_LINKS equ 0004H Sets Next Configuation 
364 
365 = 0006 F INQUIRE equ 0006H 
366 = 0008 F INQUIRE ALL equ 0008H Reports ID's of devices 
367 » OOOA F INQUIRE FIRST equ OOOAH : Reports base HP-HIL address vector 
os » 000C F REPORT _ENTRY equ OOOCH ; Reports entry point of (V_PGID) 
370 page 
371 MESSE OOO OOIGO ASO DOIKONIAOOIOOIIOIIOI OIC AOI IOIOI OOOO IOI 
372 ; V_SVIDEO subfunction codes. Use these subfunctions when 
373 > calling the video driver directly. 
374 IGOR OR OOOO IOI K FOR OKO KK KKK KK KKK KK MRK KK KKK KKK KK 
soe » F_ISR and F_SYSTEM are functions common to all drivers. 
377 


Driver Specific F_IO_CONTROL subfunctions. 
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401 0000 


405 0011 


409 0015 


003C 
003D 
OO3E 
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400 System Equate File 


SF VID ID HP equ 


0 
SF_VID_GET_INFO equ 2 
SF_VID_SET_INFO equ 4 
SF VIO MOD INFO equ 6 
SF_VIO GET RES equ 8 
SF_VID_SET_MODE equ 10 


PN CSUIDES (SdH CXCBTOe Derk eee 
; V_SVIDEO eee EX-BIOS Data Structures. 
ICAO 


EAI OOOO OIOIOIOIO OOOO IAG SIAOIORIO IOI OIA IK 
VID BLOCK SIZE equ 0027H 
VIDEO DATA struc 
VID_ATR dw 
VID _NAME_ INDEX dw ? 
VID_V_DEFAULT dw ? 
VID _ PRIMARY db ? ; Which display is primary 
VID_ SECONDARY db ? ; Which adapter is seconday (see above). 
VID_FOUND_ROM db ? , Flag set to true if rom found and init'ed 
VID_IDS db 4 DUP (?) ; Room for four possible ID's 
VID_ STATUS db 4 DUP (7) ; Room for all atatus registers. 
VID_EXT_STATUS db 4 DUP (7) ; Room for extended status registers. 
VID_PARM_ BLOCK db VIO_BLOCK_SIZE DUP (7) ; Place to save parameters 
VID_LAST_IBM_MODE db ? 
VID_EXT MODE db {; 
VIO_PADDING db H DUP (7) 
VIDEO DATA ends 


page 

id ddoppodeecooooa|noaoodobibiooioibibibbippiiptbipbiobiopbinonionieea anced 
, V_STRACK (SAH) called by logical GID drivers for cursor movement 
OK bse biiimdohay KKKKKKKKKKKAKAKKAKAKA KK AAA KKK AKAKAK KK AKA KAKA AK KKAK AKA KK 
; F_ISR and F_SYSTEM are functions common to all drivers. 


F TRACK_ INIT equ 04H ; sets nic eae bing to default state 
F_TRACK_ON equ 06H ; enables trackin 

F_ TRACK OFF equ 08H ; disables tracking 

F DEF MASKS equ OAH ; define sprite masks 

F_ SET LIMITS X equ OCH ; set max/min horizontal values 

F SET LIMITS _Y equ OEH ; set max/min vertical values 

F PUT SPRITE | equ 10H ; display sprite at initial position 
F_REMOVE_SPRITE equ 12H ; remove sprite from display 


, KKRKKKKKKKKKAKAKKKAKAKAKAKAKKAKAAKKKAKKKAKKAKAKAKKKAKKKAKAKAKAKAKAKAKAKAKKKKARKAKKAKAKKAKKAKKKKKAKKKK 
; V_ 8041 (OOAEH) Function and subfunction codes 

ye O GSS IGO IDOI IO HAO SOOO OIAN ISOS AINSI DON OA OANA OO IN OOOOOIDOIOI IK 
; F_ISR and F_SYSTEM are functions common to all drivers. 


Driver Specific F_IO CONTROL subfunctions. 


; Subfunction codes OH, 2H, 4H, 8H and 8H are reserved 
SF _CREAT_INTR equ 000AH 


as ; Create Interval Entry. 
SF DELET_INTR equ 000CH ; Delete Interval Entry. 
SF_ENABL_INTR equ OO00EH ; Enable Interval. 
SF _DISBL_INTR equ 0010H ; Disable Interval. 
SF_SET_RAMSW equ 0012H ; Set RAM Switch to 1 
SF _CLR_RAMSW equ 0014H ; Clear RAM Switch to 0 
SF SET CRTSW equ 0016H ; Set CRT Switch to l. 
SF CLR CRTSW equ 0018H ; Clear CRT Switch to 0. 


SF_ PASS THRU oie 0O01AH Pass Data Byte to HP8041. 
- Subfunction codes ICH, 1EH, 20H, 22H, 24H, 26H, 28H, 2AH, 
> 2CH and 2EH are reserved. 


p 

Bee me eT AIT re ee ee ort ere 
; Physical Graphics Input Device (GID) Function Codes 

a GOI DOIOO OOOO OS IDOIO EIS ODOC OO OIDOIOR OOO SOOO OOO OGIO IOOGK 
. F_ISR and F_SYSTEM are functions common to all drivers. 


OOOO OOOO OOOO OOOO OOO OOOO OIRO IORI IOI KOKI 

; Logical Graphics Input Device (GID) Function Codes. This is a common 

; driver for: V_LTABLET, V_LPOINTER and V LTOUCH. 

SOOO OO TO OO IO ITO IO IO IOI GIO IIE IO IOI III RIOR II IKIIOK 
F_ISR and F_SYSTEM are functions common to all drivers 


Driver specific F_IO CONTROL subfunctions 
SF TRACK _ON equ 4 


SF_TRACK OFF equ 6 
SF_CREATE_EVENT equ 8 


Equates File (continued) 


473 
474 


506 


KePOW DOU EWAH—OW DON ODUAWNH OW OAODU AUN OOM~ 
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000A 
000C 
OOOE 
0010 


» 0006 


0000 


0000 


0010 


0011 
0012 
0014 
0015 
0016 


0017 


2? 


10 [ 


SF _EVENT_ON equ OAh 
SF EVENT OFF equ OCh 
SF CLIPPING ON equ OEh 
SF CLIPPING OFF equ 10h 
F SAMPLE equ 06 


 KXKKKKKK KKK KKK KKK KKK KK KKK KKK KK KK AKK KKK KKK KK KK KKK KKKK KKK KKK KKK KKKKKAKKKKK 
, GID Data Structures 
MK RRR KKK KKK KRM KKK KKK RR KKM RK KK KK KR KOK KKK RK RK KKK KKK KK 


OOOO OOOO OOOO OOOO OOOO OOK ROKK KKK KKK 
; Physical GIO Describe Record 

, KXKKKKAKKKKKERK KKK KKKKAK KKK KKK AKKKKAKKK KKK KKK KKK KKKKKAKKKKKKKKKKKKKKKKKK 
DESCRIBE STRUC 


db size HP_SHEADER dup {?) ; this data is always offset by 

D_SOURCE db ? ; 7-4 (high nibble) contains the GID type 
. 3-0 (low nibble) is the address of the device 

D_HPHIL ID db ? ; device id byte returned by an HP-HIL device 
D_DESC_MASK db ? ; describe header from HP-HIL device 
D IO MASK db ? : I/O descriptor byte from device 
D_XDESC_MASK db ? , extended describe byte from device 
D MAX AXIS db ? ; maximum number of axes reported 
D_CLASS db ? - device class 


, 7-4 (high nibble) contains current class 
: 3-0 (low nibble) contain the default class 
D_PROMPTS db ? ; number of buttons/prompts 
a - 7-4 (high nibble) is the number of prompts 
; 39-0 (low nibble) is the number of buttons 


D_RESERVED db ? reserved for future 

D_BURST_LEN db ? maximum burst ell ay output to a device 
if devices supports more than 255 bytes then 
255 bytes is the default maximum 

D_WR_ REG db ? number of write registers supported by a device 

D_RD REG db ? , number of read registers supported by a device 

D_ TRANSITION db ? , transitions Pepor ted per button 

D STATE db ? ; current state of buttons 

D_RESOLUTION dw ? counts / cm (m) returned by HP-HIL device 

D SIZE X dw ? Maximum count of in units of resolution 

D SIZE _Y dw ? 

DABS X dw ? data reported from device 

D_ABS_Y dw ? ; that reports absolute data 

D_REL_X dw ? , Gata reported from device 

D_REL_Y dw ? that is relitive 

Db - ACCUM X dw ? these are used to accumulate scaling 

D_ACCUM_Y dw ? remainder 

DESCRIBE ENOS 

DESCRIBE SIZE equ size DESCRIBE 

OD CCP STATE equ D_STATE + 1 

D_SIZE equ OD SIZE X 

D SAMPLE ABSOLUTE equ D ABS X 

D_ SAMPLE RELATIVE equ D_REL X 

D REMAINDER ACCUM equ D ACCUM X 

O BUFFER equ D SIZE _X . offset where buffer begins 

D_ CLASS CURRENT equ OFOH 

D_CLASS DEFAULT equ OOFH 


, The field D_SOURCE uses the following masks to access the defined nibbles 
D_ADDR_ MASK equ OOFH 


D7 TYPE MASK equ OF OH 


, EXKKKKKKKKKAKKKKAKEKRAKKAKAKKKKKKKKKKKAKKK KKK KKK AKKKKKKKKAKAK KKK KKKKKKKAKKKE 
; Logical GID Describe Record 

OOOO OOOO OOOO OOOO IOI Om OmOK KKK 
LDESCRIBE STRUC 


db size HP_SHEADER dup (7?) , this data is always offset by 


LD_ SOURCE db ? , 7-4 (high nibble) contains the GID type 
- 3-0 reserved 


LD _HPHIL ID db ? device id byte returned by an HP-HIL device 
LD DEVICE STATE dw ? , status bits for logical device 

LD INDEX db ? . vector index of invoking driver 

LD MAX AXIS db ? ; Maximum number of axis reported 

LD CLASS db ? device class 


7-4 (high nibbl 

. 3-0 (low nibble 

LD_ PROMPTS db ? - number af butto 
7-4 (high nibbl 
@ 

u 


e) contains current class 

) contain the default class 
ns/prompts 

e) 1s the number of prompts 
) 
t 


3-0 (low nibbl is the number of buttons 


LD_RESERVED db ? reserved for future 

LD_RES2 db ? 

LD_RES3 db ? 

LD_RES4 db ? 

LD TRANSITION db ? transitions reported per button 

LD STATE db ? current state of buttons 

LD RESOLUTION dw ? counts / cm (m) returned by HP-HIL device 
LD_SIZE_ Xx dw ? Maximum count of in units of resolution 
LD_SIZE_Y dw ? 
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567 0024 
0026 
0028 
002A 
002C 
OO2E 
0030 
=» 0030 


[4] 
m 
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= OOFO 
=» 0OOOF 


= QOOF 
=z 00FO 


W 00 00 00 60 00 0D 60 09 00 CO NIN SII SENSO 
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a 


0010 
0008 
0004 
0002 
0001 


z 0000 
*« 0001 
» 0002 
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222? 
2272 
222? 
22777 
2272 
2727 


LD_ABS X dw ? data reported from device 

LD_ABS_Y dw ? ; that reports absolute data 

LD REL X dw ? ; data reported from device 

LO_REL Y dw ? ; that is relitive 

LD_ACCUM_X dw ? these are used to accumulate scaling 
LO ACCUM Y dw ? remainders 

LDESCRIBE ENDS 

LOESCRIBE_ SIZE equ size LDESCRIBE 

LO_SIZE equ LD_SIZE X 

LO_SAMPLE ABSOLUTE equ LO-ABS X 

LO_SAMPLE RELATIVE equ ees x 

LD REMAINDER _ACCUM equ D_ACCUM_X 

LO_BUFFER equ LD-RESOLUTION , offset where buffer begins 
; the following masks are used in the field LD CLASS 

LO_CLASS CURRENT equ OFOH 

LD_CLASS DEFAULT equ OOFH 


; The field LD_SOURCE uses the following masks to access the defined nibbles 
LO_RES MASK equ OOFH 
LDO_TYPE_MASK equ OFOH 


REEDED OEE EIT II IOI IIE TIT 
Logical GID LD DEVICE STATE 

PTET STS TESTSS OST ES OSSCSTOSOSESSOSTSSSTS CS TCS TESCO CSOT ESTES TSS TESTS TT TE 
EVENT ENABLED equ 10h 


TRACK ENABLED equ 08h 
CLIP ENABLED equ 04h 
BUTTON _ERROR equ 02H 
ISR_IN_ PROGRESS equ 01H 


PO SOURCE GID ose ee 

: SOU types 

HSE O OOOO OIE A AAA OOO OOOO QAO OIA AOI ANIA 
00H 


GID_RO8 equ 

GID_R16 equ 01H 

GID_A08 equ 02H 

GI0_A16 equ 03H 

GID_UNDEF equ OFH this undefined type is used because 


; the character input devices at the 

; current time do not have graphics el 
; and this tells the HP-HIL driver tha 

; the data type to return is determined 

; by the scancodes the device returns 


page 

MGs OOO dddpdddbipppiodipbpiobtinnbiipbnpionooaucencoonoodoionoigaoooootiepinics 

; D_CLASS and LO CLASS device tye pes 

Fh oat ibe tte Sv XXEKKXKKKKKKKKAAKAKAKKKKAKAKAKAAKAKKAAKKKKAKAKKAKKAKX 
equ 


CLASS_TS equ O1H 
CLASS_ASCII equ 02H 
CLASS BINARY equ 03H 
CLASS MOUSE equ 04H 
CLASS GIDCCP equ OSH 
CLASS TABLET equ 06H 
CLASS_JOY equ 07H 
CLASS _UNDEF8 equ 08H 
CLASS PADOOLE equ 03H 
CLASS THUMB equ OAH 
CLASS TRACKBALL equ OBH 
CLASS_KEYPAD equ OCH 
CLASS _UNDEFD equ ODH 
CLASS UNDEFE equ OEH 
CLASS _UNDEFF equ OFH 


MOLT a hed GED Lent Re ee eee 
board and GID Event Data Type 
eve XKKKKKKKKKKKKKAKAKKAKAKAKKKKE atte recenetacererotetcettectaiststetet 


T_KC_ RO equ 00H ; No key (should never occur) 

T KC _R1 equ O1H ; reserved (see HP-HIL Technical 
; Reference Manual ) 

T_KC_ASCII equ 02H ; ascii data 

T_KC_R3 equ 03H > reserved (see HP-HIL Technical 
; Reference Manual) 

T_KC_ITF equ 04H ITF scancode reported by HP150 ITF keyboard, 

HP200 ITF keyboard, barcode reader in scancode 

; mode. { Button reports are in this set ) 

T_KC_RS equ OSH ; reserved (see HP-HIL Technical 
, Reference Manual) 

T_KC_WILD equ 06H wild card set, device dependent, Button Pad uses 

T_KC_HPHIL ENVOY equ 07H reported by VECTRA Keyboard 

T_KC_IBM AT equ 08H 

T_KC_BUTTON equ 09H reported by the physical driver to the logical 
; driver PGID translates T_KC_ITF to T_KC BUTTON 
; and removes any other scancode from data stream 

rnc 18M PC equ OAH 

T_KC_HP_SOFTKEY equ OBH 

T_KC_IS_ FUNCTION equ OCH 

rhc He CCP equ ODH 

T_KC_QWERTY equ OEH 

T_KC_NUMPAD equ OFH 


> 


Equates File (continued) 


Bet Bit definitions for Keyboard Event Data Types 

663 » 0010 T_STRING equ 010H 

eee : T_STRING OOxnl ttttB indieatec a string of data bytes of type defined by the 

885 the lower nibble tttt'. The state information only 

ae applies to the first byte of data as it can be 

He ; modified by each subsequent byte of data. 

669 = 0020 T STATE equ 020H 

670 : T_STATE OOlx ttttB indicates the character type indicated 

. 671 : in ‘tttt'’ field has the current logical state 

Ae : of the keyboard appended onto it. 

674 = 0040 T GID equ 40H ; used to set and test for gid t 

675 =» 0040 TTRELO8 40H ; Be ape 

676 » 0041 T REL16 eat 41H WOME ene ree oens 

oe a 0042 T_ABSO8 equ 42H a‘ normal TOUCH SCREEN Data 

678 = 0043 T_ABS16 equ 43H ; formal TABLET data type 
= eae T_MOUSE equ 44H > specially formed data 
: ae T TS equ 45H » Specially formed data (0..80 x 0.25 default) 
popeae Ye uee equ asi : Bae ety vides data (640 x 200 default) 

_POI equ » specia windowed data (640 0 def 

» OO4F T_UNKNOWN equ 4FH > Unknown ae type. sad eee 


IOI OOOO OOOO OOK OK 
; V_LHPMOUSE (00CCH) Function and subfunction codes 

OOOO OOO OOOO OOOO ODIO IO DIO IO IOI III 1, 
, F_ISR and F_SYSTEM are functions common to all drivers. 


: Driver specific F_IO CONTROL subfunctions. 


= 0000 SF_MOUSE_COM equ 0000H ; This function is used during the 


reinit call from DOS. It is used 
to set UE INT 33H. This is done 
because DOS takes INT 33H when it 
» is initialized. 
; This function is used to force the 
; V_LHPMOUSE driver to install INT 33 
; even when the mouse is not present. 
; This allows a programmer to map 
; devices to the V_ LCHPMOUSE driver if 
; &@ mouse is not present. 


= 0002 SF_ MOUSE OVERRIDE equ 0002H 


page 

OOO OOOO IONIDOIOOOOOOOO OOOO OSORIO SONOS OROI OO I AIO 
- V HPHIL (OLI4H) Function and subfunction codes. 

OIC OOOO OOO ICO IOI IOI IORI IOR IK FOR ORCI IR I OK ROK 
; F_ISR and F_SYSTEM are functions common to all drivers. 


Driver specific F_IO CONTROL subfunctions. 


» 0004 SF_CRV_CRV_MAJ_MIN equ 0004 - This is used to set a default 
; major and minor addresses 
» 0006 SF_CRV_RECONFIGURE equ 0006 - Funtion id used to force the HP-HIL 
> link to reconfigure the devices 
= 0008 SF _CRV_WR_ PROMPTS equ 0008 - Used to write a prompt to a device 
= SF_CRV_WR_ACK equ 000A - Used to write an acknowledge to a 


device 


~~ SE ESS SS NSS SENS SSI SS SS NSN SS SE SSO DOD OO HM DO M TH OH OH O CO) GT G) OD OT HM TH 
NORD PO ADA RODD AOI Pe ee be be ee OOO OD OO OOO OW O © © OW WO WH © 0 0 GO CO 00 00 09 G0 GO 00 “i 
DOONHUBSBWN& § CWO ONDMUAUNE OW DNAUNAWN& OD DNAUNDWN OO DOWN OURWNF OW 


. SF _CRV_REPEAT equ 000Cc > Function is used to set a 30 Hz or 
, 60 Hz repeat for keyboards 
a SF _CRV_DISABLE_ REPEAT equ OOOE - Used to cancel the repeat rates in 
, keyboards 
2 000A SF_CRV_SELF_TEST equ 0010 ; Used to issue a selftest command 
- to a physical device 
=» 000C SF_CRV_REPORT_STATUS equ 0012 - Used to get the status information 
2 > that an HP-HIL device might wish to 
730 report For specific information 
731 on what is reported, see the specs 
732 ; for the device. 
733 =» QOOE SF_CRV_REPORT_NAME equ 0014 : This function is used to return the 
734 - ascii name that a device has 
735 » 0010 SF_KEYBOARD_REPEAT equ 0016 , Used to set the keyboard repeat 
736 ; and delay rates 
rt » 0012 SF_KEYBOARD_LED equ 0018 - Used to set the keyboard LEDs 
738 
739 - The functions F_PUT_BYTE, F_GET_BYTE and F_PUT_BUFFER are also supported 
740 > in this driver. 
741 
742 OIRO OOO OOO OOOO IO IO IOI IO OK IA IO IO IO KOK IO IK 0 IK 0K 
743 - System String Indexes. These are the indexes for the os in ROM 
744 - for the BASE system. If you need a particular string see the function 
7458 ; F_ STR_GET STRING in the SYSTEM routines. 
746 MK KR MRK KR RK ROKR KKK RK KK ORR ROK OR ORK KK KKK 
747 a 0800 INDX DRIVE_A equ 2048+0 
748 « 0801 INDX DRIVE B equ 2048+) 
749 » 0802 INDX DRIVE _C equ 204842 
750 » 0803 INDX DRIVE D equ 204843 
751 = 0804 INDX ORIVE_E equ 2048+4 
752 = 0805 INDX DRIVE F equ 2048+5 
753 2 0806 INDX ORIVE G equ 2048+6 
754 » 0807 INDOX DRIVE_H equ 2048+7 
755 = 0808 INDX DRIVE I equ 2048+8 
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756 
787 
758 
759 
760 
761 
762 
763 


dN A ed A SA Sd ed ed et gy 
W 60 CO CO 090 60 00 C0 0 09 CO SIS SI SI 
ODOONMUNIS WN OO DM™~MD UIE WAY 


NN SA 
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&UONe 


CO OO O00 OO EN SY 
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OM aWNrF ODM ONMAW” 
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id Huntnea ene Ld] 


(oko XoXokosokokokolololokololosolosololololosovolo Roses es eore) 
00 08 00 & GO 00 CO 09 09 09 00 00 00 00 CO OD ODO MOCO MMMM WOW OW OO 
RIMINI DD DD DD FB Re ee ee Re eRe OO OOOO 
AWN eWUNrOTFMNMOODPWOBNMAMNAaWNHONM IOOWPYPw 


0000 
0001 
0002 
0003 
0004 


0005 


0008 
0009 
000A 
0008 


000C 
000D 


QOOE 
OOOF 


0010 


0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 


0009 


000A 
000B 
000C 
0000 
QOOE 
OO00F 


INDX DRIVE _J equ 2048+9 

INDX DRIVE _K equ 2048+10 
INDX DRIVE L equ 2048+11 
INDX DRIVE _M equ 2048+12 
INOX_DRIVE_N equ 2048413 
INOX DRIVE_O equ 2048+14 
INOX DRIVE P equ 2048+15 
INOX DRIVE Q equ 2048+16 
INDX DRIVE R equ 2048+17 
INDX DRIVE_S equ 2048+18 
INOX DRIVE T equ 2048+19 
INDX DRIVE _U equ 2048+20 
INDX DRIVE V equ 2048421 
INDX_ DRIVE W equ 2048+22 
INDX DRIVE X equ 2048+23 
INDX DRIVE _Y equ 2048+24 
INDX_ ORIVE Z equ 2048+25 
INDX_HP_ COPYRIGHT equ 2048+26 
INDX_SETUP_MSG equ 2048+27 
INDX RETRY MSG equ 2048+28 
INDX_ INVALID ROM MSG equ 2048+29 
INDX_KYB_LOCKED MSG equ 2048+30 
INDX_STRIKE_F1 MSG equ 2048+31 
INDX BOOT ERROR _MSG equ 2048+32 
INOX TOUCH equ 2048+33 
INOX TABLET equ 2048+34 
INDX MOUSE edu 2048+35 
INDX_ KEYBOARD equ 2048+36 
INDX_ BARCODE equ 2048+37 
INDX_KNOB equ 2048438 


IICIOIOOOOO OOOO OOOO OOOO IOC IOI IK 
pieeeeeareenee equates. 


FIO OOIOGIO OOOO OO OI AOO OOOO OIOSIOIOIGOIOOIOIO OOOO IOOSOI CISCO IOI ITOK 
INT DIVIDE ZERO equ OOH 
INT SINGLE STEP equ O1H 
INT_NMI equ 02H 
INT BREAKPOINT equ 03H 
INT_OVERFLOW equ 04H 


JRE IIT TIT TT ET TTT TIT ET TATE 
; Print Screen Service 

DIO OOOO OOO OOO SOO OOOO OIOOOIOOOOOIOIGIOIOIRI DIORA OOO OIC OOOO IOI IK 
INT_PRINT SCREEN equ OSH 


DRO O OOOO OOOO OOOO IIS OI III IOI 
; 8259 Master Interrupt Controller Hardware Interrupts 
UII C OCA OOOO OOOO OOO IOI IK 


INT_IRQO_TIMER equ 08H 
INT_IRQ1_ KBD_ISR equ 09H 
INT_IRQ2 equ OAH 
INT_IRQ3_SERIAL1 equ OBH 
INT_IRQ4 SERIALO equ OCH 
INT_IRQS_PRN1 equ ODH 
INT_IRQ6_ FLOPPY equ OEH 
INT_IRQ7_PRNO equ OFH 


OOOO OOOO OOO OO OOOO OOK 
: Interrupt 10H Video Support Functions 
UNO OOOO OOOO OICOGAOOSSASIOIO OOOO RSIS IDIOIOI OOOO IOI IORI 


NT_VIDEO equ 10H :Video Functions Interrupt 

F10_ SET MODE equ 00H ;Set Video Mode 

F10_ SET CURSIZE equ 01H :Set Cursor Size 

F10 SET CURPOS equ 02H ;Set Cursor Position 

F10 RD _CuRPOS equ 03H ;Read Cursor Position 

F10_ RD PENPOS equ 04H ‘Read Light-Pen Position 

F10 SET PAGE equ OSH Set Active Display Page 

F10 SCROLL _UP equ 06H :Scroll Rectang te bp 

F10 SCROLL DN equ 07H :Scroll Rectangle Down 

F10_ RD _CHARATR equ 08H ,Read Character and Attribute at 
‘Cursor Position 

F10 WR _CHARATR equ 09H ‘Write Character and Attribute at 
‘Cursor Position 

F10 WR _CHARCUR equ OAH ‘Write Character at Cursor Position 

F110 SET PALLET equ OBH ;Set Color Pallet 

F110 WR PIXEL equ OCH ‘Write Pixel Dot 

F10 RD_PIXEL equ 0ODH :Read Pixel Dot 

F1l10 WR CHARTEL equ OEH :Teletype Character Write 

F10_GET_STMODE :Get Video State and Mode 


equ OFH 
Function codes 10H - 12H are reserved 
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; Write String Functions 
F1id WRS 00 equ 1300H ‘Global Attribute 
F1O WRS O01 equ 1301H ;Global Attribute, Move Cursor 
F10 WRS 02 equ 1302H ‘Individual Aerie: 
F1O WRS 03 equ 1303H ‘Individual Attributes, Move Cursor 
F10 INQUIRE equ 6FOOH ,EX-BIOS present 
FiO GET _INFO equ 6FO1LH ;Get video parameters 
F10 SET_INFO equ 6FO2H ;Sets video parameter 
Fi0_ MOD_INFO equ 6FO3H ‘Modifies video parameters 
F10 GET RES equ 6FO4H ;Reports video resoultion 
F10 XSET MODE equ 6FOSH ,Sets video resolution 
OOOO OOOO OOOO OO OO IOI mI IO OK OK CK 
: Interrupt 11H. Equipment Determination Function 
OOOO OOOO OOO EIKO OIG IGS IO ICO IOI COI IO OO SIO OE II 
NT _ EQUIPMENT equ 11H ‘Equipment Determination Interrupt 


, KXRAKKKKAKK AK KAA KAKA KEKAK KKK KKK KKH KK KKK K KAKA KKKKK KKK AKA K KKK KKK KKK KKK KKK KEK 
. Interrupt 12H, Report oyoi en Memory Size 

NEGO IOC IO OSI AOI IIE KKKKKKKKKKA KKK KKK KKKKAKKKAKKAKAKKAKKKKAKKKKAKAKKKKKKK KK 
INT MEM SIZE equ 12H :Memory Size Interrupt 


OOOO OOOO OOK ORO ROO OR IOI IOI OIOIOIOI OR IOIOIOR IOIOIIOIOR SOIR OK WC 
. Interrupt 13H, Internal Disc Support Functions (Flexible and Hard discs} 
AOR AOSD A AOA IIIA TIO I IT I OT II 


INT DISC equ 13H ;Hard Disc Functions Interrupt 
F13_ RESET DISC equ 00H ‘Reset Hard Disc 
F13_ RD LSTATUS equ 01H ‘Read Status of Last Operation 
Fi3_ RD SECTORS equ 02H ‘Read Sectors 
F13 WR _SECTORS equ 03H ‘Write Sectors 
F13 VR SECTORS equ 04H :Verify Sectors 
F13 FORMAT FLEX equ 05H ‘Format Diskette Track 
, Function code O6H is reserved 
Fi3 FORMAT HDISC equ 07H ‘Format Hard Disc 
F13_GET_HPARMS equ 08H -Get Hard Disc Parameters 
, Function codes 09H - OBH are reserved 
F13_ TRACK SEEK equ OCH ;Seek to Track 
F13_ALT_RESET equ ODH ‘Alternate Hard Disc Reset 
. Function codes O€H - O014H are reserved 
F13 GET DASD equ 15H ‘Read Disc Type (DASD) 
F13_CHG STATUS equ 16H .Get Disc Change Line Status 
F13 SET DASD equ 17H .Set Disc Type for Flexible Disc 


Formatting(OASD) 


OOOO OOOO OOOO OOOO OF Iam Ia IORI OR IO KOK 
» Interrupt 14H, Serial Communications Functions 
EKO EIR OTA TC II IO TAA II IIE 


INT. SERIAL equ 14H ;Serial Communications driver 
Fl4 INIT equ 00H ;Initialize Serial Port Parameters 
F14 XMIT equ O1H ,Send Out One Character 
Fla RECV equ 02H ‘Receive One Character 
Fld STATUS equ 03H ‘Get Serial Port Status 
F14 INQUIRE equ 6FOOH .Reports if EX-BIOS Functions 
> are present 
Fi4 EXINIT equ 6FO1H ‘Initializes serial port 
; (19.2 Kbaud) 
F14 PUT BUFFER equ 6FO2H Writes a buffer of data 
F14 GET BUFFER equ 6FO3H ;Reads a buffer of data 
Fi4 TRM_BUFFER equ 6FO4H ;Reads a buffer of data, 


,terminates on specified condition. 


BIOS OOOO OOOO IOI IO IO OKIKIICIOK NOK IK 
, Interrupt 15H, System Control Functions (Processor Mode Switch, Extended 


Memory Functions, ETC 
1210210 KXXKKKKXK 


INT_ SYSTEM equ 15H ;System/Cassette Functions Interrupt 
, function codes 0 - 3 for Cassette panees are Unsupported 
FiS DEVICE OPEN equ 80H ;Device O 
FiS DEVICE CLOSE equ 81H ‘Device C Be 
F1S PROG TERM equ 82H :Program Termination 
FiS WAIT_EVENT equ 83H -Event Wait 
F1S JOYSTICK equ 84H .Joystick Support 
F1i5_ SYS_REQ equ 85H ;System Request Key Pressed 
F1S WAIT equ 86H Wait Fixed Amount of Time 
FiS BLOCK MOVE equ 87H ;Move Block of Memory to/from 
,Extended Memory 
FiS GET XMEM SIZE equ 88H .Get Extended Memory Size 
F1IS_ ENTER PROT equ 89H ,Switch to Protected Mode 
F1S DEV_BUSY equ 8AH ;Device Busy Loop 
FiS INT COMPLETE equ 8BH :Set Interrupt Completed Flag 
Me sata a pace et ipl a ata 
. Interrupt 16H board Support Functions 
JQ OOOO OE OOO Og uO Sno pnnninioionioapnoecaodnnbbinbinaaancgnn: 
NT_KBO equ 16H ;Keyboard Driver 
F16 GET_KEY equ 00H ;Read keycode from Keyboard Buffer 
F168 STATUS equ O1H Report Status of keyboard buffer 
F16 KEY STATE equ 02H ;Get Key Modifier Status 
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934 = 6F00 
935 =» 6FO1 


937 = 6FO02 
939 = 6F03 
941 = 6F04 


944 = 6F05 
947 = 6F06 
950 = 6FO7 


953 2 6FO8 
954 
955 =» 6F09 
956 
957 


977 
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= 0018 


1004 » 001C 


» 0010 


» OO1E 


= OO1F 


= 0021 


Oe ee be be be ee eb ee bm 
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F16 INQUIRE equ 6F OOH ;Inquire EX-BIOS Functions present 

Fi6 DEF_ATTR equ 6FO1H ‘Reports default values for repeat 
;rates and pane | time before repeat. 

Fi6 GET_ATTR equ 6FO2H :Reports current repeat rates and 
:delay time. 

Fi6 SET_ATTR equ 6FO3H Pee current repeat rates and 
;delay time. 

F16 DEF MAPPING equ 6FO4H oe: default HP-System vector 
entries for keyboard translator 
‘drivers. 

Fi6 GET MAPPING equ 6FOSH ;Reports current HP-System vector 
; entries for keyboard translator 
, drivers. 

Fi6 SET _MAPPING equ 6FO6H ;Replaces current HP-System vector 
; entries for keyboard translator 
; drivers. 

Fi6é SET XLATORS equ 6FO7H ‘Switches either the cursor control 


pad translator or the HP Softkey 
; translator functions 


F18_ KBD equ 6FO08H ;Reports keyboard HP-HIL address and 
; Identification. 


Fi6_KBD_RESET equ 6FOSH ;Resets logical keyboard structure 
; to defaults. 


- RKKKKKKKKKKKKKKAKKKKAKKKKKKAKKKAKAKKKAKKKKAAKAKKRAKAKKKAKKAKKKAKAKAKKKKKAKAKKKKAKKAKKKKAKAKKK 
> Interrupt 17H, Printer Support Functions 
OOOO IO IO OO IOIO IO OOO IO IOI IOROIOIOIOIOK 1 ROK ORCI CCK I IC OK 


INT PRINTER equ 17H ;Printer Port Support Interrupt 

F17_PUT CHAR equ 00H :Send Printer One Byte 

Fi7_INIT equ O1H Initialize Printer 

Fil7 STATUS equ 02H ;Get Printer Status 

F1I7 INQUIRE equ 6FO0H ;Reports EX-BIOS functions exists 

Fi7_ READ_STATUS equ 6FO1LH ‘Reports the status of a printer 
; port read buffer. 

F17_PUT_BUFFER equ 6FO2H ‘Writes a buffer of data to the 
; printer port. 

Fi7_ GET BUFFER equ 6FO3H ‘Reads a buffer of data. 

F17_TRM_BUFFER equ 6FO4H ;Reads a buffer of data from the 


port, terminates on specified 
condition 


ai a a a as 
: eboot System 

IO OOOO OOOO OOOO OOO OOO OOOO OO IO OOK OK IOK KK 
INT BOOT equ 19H ; Reboot System 


IOI IOI OOOO IOIOIO IOIOIO IO IOI IOI IOIOIOIOIO OI IO I IOIOIOR KOK 
; Interrupt LAH, Real-Time Clock Support Functions 

AOI OOOO OOOO OO IO OIC OOOO IOI IOI IOI OK 9K OK 40K 
INT CLOCK equ 1AH Clock Functions Interrupt 


FIA RD_CLK CNT equ 00H >Read Current Clock Count 
F1A_SET_CLK_CNT equ 01H :Set Current Clock Count 

FIA GET RTC equ 02H ;Read Real-Time Clock 

FIA _SET_ RTC equ 03H ;Set Real-Time Clock 

FiA_GET DATE equ 04H :Read Date from Real-Time Clock 
FIA _SET DATE equ 05H ;Set Date in Real-Time Clock 
F1A_SET ALARM equ O6H ;Set Alarm 

F1A_RESET_ALARM equ 07H ;Reset Alarm 


ere a VE IRAGa ea eee ee 
: nterrup H reak Ke 

OOOO ORK IK IKK KKKKXKEXKKKEKKKKAKAKKKAKAKAKAKAKAAKAKAKAKAKKAKAKKAKKKAKKAKKKKK 
INT _BREAK_EVENT equ BH 


pee re ee eee Rene ee Der ees 
; Timer Tick Event 

» EXXKKKKAAAAAAKAKAAAAKAKAAKKKKAKAKAAKAKAKAAKAKAKKEKKKAKAKKKKRKAKAKAKKAKAKAKARKKAKKKKKAKARKKK 
INT TIMER TICK equ H 


; EEE EEE ALTER TELIA TL AA TEA TNE TA 
; Video Parameters 

INAOOAOOOOOO AO ICAO ICAO IAOICOAOO AIO OOOO IO AIO IONIAN IR IOK 
INT VIDEO PARMS equ DH 


; XXXKXKKKKAKAKAKAAKAKAAAAKAKAAKAKAKAKKKAAAKAAAKAKAKKKAAAAKAEKAKAAKAKKKAAKKKKAKAKAAKAKAKAKAAAK 
; Floppy Parameters 

, RXKKARAKKKAAKKAKKKAEKAAKAAAAKKAEKAAKAKKAAAKAAKKAKKKKKAKKKAKKAKKKKKAKAKKKKAKAKAAAKAKKAAK 
INT_FLOPPY_PARMS equ 1EH 


IRI DIE IOI OOOO OIOOOIOIOIOIOI SOOO AIOIOISRIDIOIGIIOI IISA CARIOICOIOIOIIOI IOI III IO 
; Graphics Characters Table 

MIAO OOOO OA O IO OIOIOEOO OMAR OIOASIOI CASAC TIERCE IC III 
INT GRAPHICS CHAR equ 1FH 


, KXXKKKKAAKKAKAKAKAKKKAKAKAAKKAAAKKKKKKKKKKAKAKAAAKAAKKKAKKKAKAKAAKAKRAKKAKKKKAKKKKKKAKAKAKAKRAKAKAK KKK 
; DOS Function call interrupt 

fue BGC ee te ee eee ee ene 
NT_DOS equ 1 


, RKKKKKKAKAKAK AKA KAKA KAKA AKA A AKKAK AK AAA AK AAKAAKAKAKAAKAKAKAKAAKAKAKAKAK AKA KAA AKAKKAKAAKAKA KA 
' Interrupt 33H, HP Mouse Support (MS-Mouse Emulation) 


0040 


0041 


0046 


004A 


0068 
0069 
006C 


qagooo0o°cdeo 
eoooo0o00°o 
SN SENSES 
SOW & WN O 


: Full AX register used for function code 
- KXXKKKKXKKAKEKAAKKAAKKAAKKAKAKAKKKAKAKAKKKKKAKKKKKKKKKKAKKKKAARKKKKKKAAKAKKKKAKKKKAKAKAKKAKK 


INT _HPMOUSE equ 33H 
F33_ INSTALL equ 0000H ; Mouse installed flag and reset hardware. 
F33_ ENABLE equ O001H ; Put cursor on screen. 
F33_ DISABLE equ 0002H - Turn off cursor. 
F33 REPORT DATA equ 0003H ; Get positional data and button info 
F33_ PUT CURSOR equ 0004H : Positon the cursor. 
F33_ REPORT PRESS equ 0005H ; Report button press status 
F33 REPORT RELEASE equ 0006H ; Report button release information. 
F33_ SET_HORIZ equ 0007H ; Se min toum and maximum horizontal 
values. 

F33 SET VERT equ 0008H ; Set min and max vertical values. 
F33_ GRAPH CURSOR equ 0009H ; Define the graphics cursor. 
F33_ TEXT CURSOR equ OOO0AH : Define the text cursor. 
F33 MOTION equ 000BH ; Report motion counters. 
F33 SET _USR equ 000CH : Define user subroutine call. 
F33_ENABLE LIGHT equ 000DH ; Enable ee pen emulation mode. 
F33_ DISABLE LIGHT equ OOOEH ; Disable ight pen emulation. 
F33 RATIO equ OOOFH ; Set pixel movement ratio. 
F33_COND OFF equ 0010H ; Define area to conditionally turn 

; display off. Not used. 
F33_XTENO_GCSR equ 0012H ; Extended sprite graphics entry point. 
F33_ SPEED equ 0013H ; Set mouse doubling speed factor. 
F33 


_ INQUIRE equ 6FOOH ; Returns “HP" in bx if HPMOUSE driver 
; is being used. 


OOOO OOOO OOOO OOOO OOO OOO ORK KK 
; When there 1s a fixed disc installed, direct entrypoint to flopp 

, RAKKKKKAAKAAKKAKAAAAKKAAKAKA KKK AAAAKAKAKAKAKKKAAK KKK KAEKA KAKA KAKA KKKAKKAKAKAKAKAKKAKAKKKKKAKK 
INT_FLOPPY DIRECT equ 40H 


Pete Breeton e ee eae renee erent re eee anaee 
: xe isc Parameters 

: XXKRKKKKKKKKKKKKKAAAKAKKAKKKKKKAKAKKKKKAKAKAKKKKAKAKKK KKK KKKKKKAKKKAKKRKKKKKKKK KEK 
INT_HDISC_PARMSO equ 1H 


Re tate ee eee ee eee ane OREN On TTS ERAN Eee 
; Fixed Disc Parameters 

- REKKKKKKKKAKAKKKKAKAKKKAKAKKKAKKAKAKAKAKKKKKAKAKKKAKKAAKKKAKAKKKKAKAAKK KKAKKAKKKKKKKKKKAKK KKK 
INT_HDISC_PARMS1 equ 6H 


- KXKKKKKAKKAKAAKKKKAKKAKKAKKAKAKKKAAKKAKAKAKKAKKAKAKKKKKKAKKKKRAKKAKKAKKKKKRK KKK KKK KEK KKK KK 
; Real Time Clock Event vector 

, KEKKKKAKKKAAKKAKAKKKKAAKKKAK KAKA AKKAKAKKAKAKAKKKKAAAKKAKKKKKAAKAKKAKAKK KKK KK KKKKKKKKKK KKK 
INT _RTC_EVENT equ 4AH 


OOOO OOOO OOO OOOO OOO OOOO OOOO OO IO IOI RIOR IOROK#0KO% 
; 8259 EX-BIOS Slave Interrupt Controller 

OOOO OOOO OOOO OOOO IOI IO OOK 
INT SVC_REQUEST equ 68H 

INT 804] OBF equ 69H 

INT_HPHIL equ 6CH 


OOOO OOOO OOOO OOOO OO OOOO IO IO OR IO FR ROR OOK ROK ORK KOK 
; 8259 Slave Interrupt Controller Interrupts 
OOOO” OOOO OOOO IO IGOR III OK ROK IO RIKKI IK CR CIO 


IRQ& RTC equ 70H 
IRQS REDIRECT equ 71H 
IRQ1O equ 72H 
IRQ11 equ 73H 
IRQ12 equ 74H 
IRQ13_287 equ 75H 
IRQ14 HDISC equ 76H 
TRQIS equ 77H 


- EXKKKKKEKKKKKKKKKKKKKAKKAKKKKKAKKKKKAKAKAKKAKKAKKKKKAKKAKKAKAKK KKK KKKAKKKKKAKKKAKKKEKK 
- MS-DOS Installable Device Driver Equates and Structures 
OIRO OOOO OOOO OOO OKO KK KK KR KKK KKK 


MSO _ERR STATUS equ 10000001B -used as upper byte in status wrd 
MSD_DONE_STATUS equ 000000018 > bit l5*err bit 8#done 
; Equates for standard MSDOS errors. 

MSD_WRITE PROTECT equ 0 

MSD UNKNOWN UNIT equ O1H 

MSD_NOT READY equ 02H 

MSD UNKNOWN CMO equ 03H 

MSD _CRC_ERROR equ 04H 

MSD _ BAD LENGTH equ OSH ,bad request length error 
MSD SEEK_ERROR equ 06H 

MSD_UNKNOWN MEDIA equ 07H 

MSD _SEC_NOTFND equ 08H ;sector not found 

MSD_ PAPER OUT equ 09H 

MSD WRITE FAULT equ OAH 

MSO_READ FAULT equ OBH 

MSD_GEN FAILURE equ OCH 

MSD_BAD_DCHG equ ODH ;bad disk change error 


; KKKKKKAAKAAKAKKAAAKAAKAKAKAKAAKAKAAKAKAKKAKAAKKAKAKKKKRKKAK KAKA KAKAKAAKK KKK KKK AK AKKKKAKKKKKKK 


- Command Equates => the following list are the commands defined for MS-DOS 
installable device drivers. 


PTT TST TT TTT SST OTST SSS STS SOT STU SST TTS T SSeS SS SESS TST SSS SSS S TST E SS SSeS SST S SS TSS SS 
MSD _ INIT equ 


0 
MSD_MEDIA_CHK equ 01H ;media check command 
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0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
OO0A 
0008 
-000C 
000D 
QOOE 
OOOF 


WOMAN PWN HH OCOWODONAUNESWNFOWOYN MM aWNFHOOONAUAW 


1 
l 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
l 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 


OMOUWNMWMNUOAUTUNUUN PP Pa HLH HPAWWW WWWWWWUNNYNNMYNAD 


1 
1 
1 
1 
1 
1 
1 
1 
i 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 


0000 


0000 
OOOE 
0010 
0012 
0014 
0016 
0017 


0000 


0000 
0002 
0004 
0006 


NaWNHOWOWNAMUAWNHOWOONONURBWNF OW ONDUE WN OW ONDUNSUNF OD ONAN EWN O 


6 
6 
6 
6 
6 
6 
6 
6 
6 
7 
7 
7 
7 
7 
7 
7 
7 
7 
7 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
9 
9 
9 
9 
9 
9 
9 
9 
9 
9 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
1 
1 
1 
1 
1 
1 


li 
di 
ll 
11 
ll 
ll 
ll 
11 
11 
11 
li 
li 
li 
11 
ll 
11 
11 
1i 
11 
ll 
li 
ll 
li 
ll 
li 
ll 
11 
Ad 
li 
11 
11 
11 
ll 
li 
11 
11 
li 
ll 
ll 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 
12 


0008 
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7? 


eae 2? 


7??? 
ere 
2777 
222? 
222? 


227?? 


(eee: 
TL 2e 


277? 


2777 


Equate File 


quates File (continued) 


MSOD_BLD_BPB equ 02H ‘build Bios Parameter Block 
MSD_IOCTL_IN equ 03H -1/0 control input 

MSD_ INPUT equ 04H 

MSD_IN_NOWAIT equ OSH -Non-destructive input with no wait 
MSD_IN_ STATUS equ 06H 

MSD_IN FLUSH equ 07H 

MSD_ OUTPUT equ 08H 

MSD _OUT VERIFY equ 09H 

MSD OUT STATUS equ OAH 

MSD _OUT_FLUSH equ 0BH 

MSD_IOCTL_OUT equ OCH 

MSD_DEV_OPEN equ ODH ;device open and close commands 
MSD _DEV_CLOSE equ OEH 

MSD_REM_MEDIA equ OFH ;removable media command 


page 

» IRR OK IK ROK KKK RIOR RK KR RK RCI IO KKK IK RK IK RR OK OK IKK 
- use this macro to setup the MS-DOS driver header required at the top of 

- any installable device driver 

© MR KK ROR ARR ICICI A I RRR OR RR KR KK IK 


msd_header macro ATT STRATEGY ENTRY ,ISR_ENTRY,STRING 
dd -1 smark as last driver in list 
dw ATT 
dw STRATEGY ENTRY 
dw ISR_ ENTRY 
db STRING 
a 14 dup (7?) : Pad so it is paragraph aligned. 
endm 


= MRE MORK RO IR KR KKK RRR KK KOK KK KKK OK IRR KEK IIR IK RK RI RK IK KKK KK KK 
: the Ucderinalt structures are used to access MS-DOS driver command blocks 
ott 8 58 5555555850555 5955595995999 559999 5259595958005 8 058 800202 0s 2 so 583 ot 2d 2d 8 | 
MSD REQ HEADER struc oo structure for access to MS driver cmds 


MSD_CMDOLEN db ? ;00; eae of cmd in bytes including data @ end 
MSO_UNIT db ? :01; unit number for command 
MSD _CMD db ? -02; command code 
MSD_STATUS dw ? -03; faller with completion status before return 
db 8 dup (7) g - area reserved for DOS 
MSD_MEDIA db ? 13; most cmds have this defined in the data area 
MSD_ TRANS dw ? (14; 
dw ? 16; 
MSD_COUNT dw ? 18, 
MSD _ START dw ? 20; 


MSD REQ HEADER ends 

TS TT eS eT ST TOTS tt 55055555559 05559 9 9055599559555 02508 0 od 00500 058 605 9 08} 2 9d 20 28 | 
- Access to the data area of the INIT driver command 

PTS T CST S ESOT SSS SPSS S555 59550595 99559595959 59595959 99 00> 02 od do 0062 od 29 05 0d 9 | 
MSD_INIT_CMOD oe 


13 dup (7) ‘first cover header area 
MSD_UNIT COUNT db ? - OB ;number of units service by this driver 
MSD_END_OFFSET dw ? - OC :offset of end of code 
MSD_END SEG dw ? ; OE ;segment address of end of code 
MSD BPB OFFSET dw f aap tae 
MSD BPB_ SEG dw ? - 14 :seg offset of BPB list for units attached 
MSD_1ST_UNIT db ? - 16 ;tells driver letter of first unit 


MSD_INIT_CMD ends 


page 
UE OSS OSA NISO SOOO DORON OOIOISONIOOIO OOOO IOD OOO OOOO OOO OID OOOO OOOO 
- Access to the data area for INPUT or OUTPUT driver commands 
KKK KKKKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK RK KK KK KKK KR KKK KKM KKK KKK KKK KK KK KKK EX 
MSD_I0_CMO struc 

db 14 dup (7) ,Media byte defined in header. 


MSD_XFER OFFSET dw ? 

MSD_XFER_SEG dw ? -full address of buffer for data transfer 
MSO_XFER COUNT dw ? ;could be bytes or block count 
MSD_1ST_BLK dw ? ‘address of first block to read or write 
MSD_VERR_ SEG dw ? ‘pointer to volume id if err code => OFh 


+ EKKKKKKKK AAA AK AK AKA KKK AK KK AK AK A AK A KAKA KK MH KHAKI KKK HHH HHH KKK KKK KOK KK KKK OK 
Structure Definition For segment 40h, STD-BIOS Data Area 


PST TTC CS TT CCST CLES TOSS SSS TESST OST S SESS SSS SSS TSS ESS SS OTT T TE SESS SST T ES SS ESSE SES | 
SEGMENT40 struc 
EIA communication ech 
Ww 


: port address table 
$40_RS232_PORT1 ADR ; 04 


a = i ? 0:0000 address of serial port 1 
$40_RS232_PORT2_ ADR dw ? ; 040:0002 address of serial port 2 
$40 RS232_PORT3_ADR dw ? ; 040:0004 address of serial port 3 
$40_RS232_PORT4 ADR dw ? - 040:0006 address of serial port 4 


Parallel printer base I/0 or address table 
S$40_PRINT_PORT1 ADR dw ; 040:0008 address of parallel port 1 


be ee pe ee ee ee be be pee ee ee ee ee eb ee bb bb be pe be pe bb bb Pb ee Bt bp bb 


Equates File (continued) 


216 000A ?7?? S40 PRINT _PORT2_ ADR dw ? - 040:000A address of parallel port 2 
217 000C 777? S40_ PRINT PORT3_ ADR dw ? - 040:000C address of parallel port 3 
ate OOOE 777? S40 PRINT _PORT4 ADR dw ? 040:000E address of parallel port 4 
220 : System configuration 
221 0010 7777 $40 EQUIPMENT FLAG dw ? - 040:0010 word identifying installed devices 
222 0012 7? S40 MFG INIT db ? 040:0012 manufacturing initailization/test byte 
223 0013 7777 S40 MEMORY SIZE dw ? - 040:0013 memory size in ik bytes 
224 0015 ?? S40_MFG_ERR FLAGI db 7? ; 040:0015 manufacturing scratchpad 
See OoO1ls 77? $40 MFG_ERR_FLAG2 db ? - 040:0016 manufacturing error codes 
227 ; hea ee data area 
228 0017 ?? $40_ BO_STATE1 db ? - 040:0017 state of special keys: shift, caps, etc. 
oon 0018 7? $40 _KBD_STATE2 db ? ' 040:0018 secondary state of special keys 
231 0019 ?? $40 _ALT_INPUT ACCUM db ? - 040:0019 accumulator for alt/numpad entry 
232 OOLA 777? $40 _KBD_BUF_HEAD dw ? ; 040:001A keyboard buffer head pointer 
233 001C 7777? $40 KB8O_ BUF TAIL dw ? ; 040:001C keyboard buffer tail pointer 
oe OO1E 10 [ er $40 _KBD_BUFFER dw 16 dup (7) - O40:001E keyboard buffer, 15 entries + overrun 
236 
237 
238 : 
se oose 1 cob PPBBDV EEE gtt™ ag 
be - T db ? ; 040:003E fl 
241 OO03F ?? S40 FLOPPY MOTOR STAT db ? ; 040:003F ‘apey Stive notee ealey 
242 0040 ?? S40 FLOPPY TIME OUT db ? ; 040:0040 floppy drive timeout counter 
aa or 2? a S40 FLOPPY RETURN STAT db? ; 040:0041 floppy drive return code/error status 
a { - S40 FLOPPY CONTRL_STAT db 7 dup (7) ; 040:0042 floppy controller status/hard disk 
246 ] 
247 
248 
c d 
Py db ? ; 040-0049 
251 004A 777? S40 CRT WIDTH dw ? ; 040:004A eieeont Simeee cts 
SB> bas : current number of screen columns 
004C 77??? $40 _CRT_LENGTH dw ? ; 040:004C current length of screen in bytes 
253 OO4E 777? S40 CRT PAGE ADR dw ? ; 040:-004E starti d 
Sea i starting address of current display page 
ar 0050 08 [ er $40 CRT _CURSOR POS dw 8 dup (7?) ; 040.0050 cursor coordinates (row,column) 
256 | } 
257 
58g 0060 777? $40_CRT CURSOR Lo reer ae ae 
ay Ree ae as se) MODE dw ? ; 040.0060 current cursor mode setting 
°7 S40 CRT DISPLAY PAGE db ? , 040.0062 current display page 
ae 0063 777? $40 CRT _PORT_ADR dw ? ; 040:0063 base I/0 port address for 
: tive crt controller 
263 0065 ?? S40_CRT MODE SEL_REG db ? ; 040.0065 st i 
ae 0066 7? S40_CRT_PALETTE ~ db ? : 040:0066 PR lee Daletie cet tere be 
266 : Option ROM data area 
267 0067 7??? $40_XROM_INIT_ADR dw ? . 040.0067 offset address for optional 
cee 0069 777? $40 XROM SEGMENT d ? 040 0069 ae ae saa te 
i = Ww : segment address for optional I/0 rom 
ee 0068 77 S40_XROM_INT_FLAG db ? ; 040.0068 flags last interrupt iat occured 
13 ose 7777 sao ‘Tine tow Or" 
7227 uo R_LOW dw ? ; 040-006 
278 00BE 2777 §40~TIMR~HIGH dw? PiONO) O0GE Moni bight scsat wend OY liner ecuay. 
sie S40_TIMR_OVR_FLOW db ? / 040:0070 24-hour timer tick rollover counter 
378 0071 7? é40° Sys BREAK FLAG 
f 7 a AK_FLAG db ? ; 040:007 
es 0072 77??? $40 SYS RESET FLAG dw ? 040.0072 sft oe raat aa Meee 
oes ia cos a disk data area 
07 _FD_STATUS db ? ; 040 00 h i i 
283 0075 ?? S40_FD_COUNT db ? ; nes eanbee ct peee gee Gee onic Reais Tee 
284 0076 ?? $40 FD CONTROL db ? . 040.0076 copy of hard disk controller register 
ae 0077 7? S40_FD_PORT_OFFSET db ? 040.0077 hard disk port offset 
287 Parallel printer timeout table 
288 0678 7? $40 PRINT TIMEOUTL db ? ; 040 007 
289 0079 7? S40 PRINT TIMEOUT2 db ? 040 0079 nen le ae ; eee Se 
290 OO7TA ?? $40 PRINT TIMEOUT3 db ? ; 040:007A parallel printer 3 timeout count 
ot 007B ?? S40_PRINT_TIMEOUT4 db ? 040:.007B parallel printer 4 timeout count 
293 
Bf core sab esse? PinebUTEO’ BE 
_R _TIMEOUT1 db ? 040 .007C ial t 1 ti 
296 007D ?? $40 RS232 TIMEOUT2 db ? 040 007D eOriad Bort 2 net Sour 
297 OO7E ?? S40 _RS232 TIMEOUTS db ? 040 OO7E serial port 3 timeout count 
a QOO7F ?? S40_R35232_ TIMEOUTS db ? 040:007F serial port 4 timeout count 
300 ' Keyboard buffer pointers 
+ 0080 777? $40 KBD_BUF START dw ? , 040:0080 es Ae ies start of 
eyboar uffer 
f4 0082 77??? $40 KBD _BUF_END dw ? . 040.0082 pointer to physical end of 
: eyboard buff 
ee oon 7 sab °EaR ER gBNca MAPGST JEOA) data eves ee 
7 _EGA_ N db ; 040 0084 number of crt rows minus one 
ae 0085 ?7?? $40 EGA CHAR SIZE dw ? ; 040.0085 pala tes per character 
y in on a e 
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WWWWWWO WWW WWWOWWWWWWWWWO LW WWW WOIWWWWWw 
PEP BWW YW O61) WG OO DD PIRI BO DDD BR Re Re ee OO 
PWN OOOnADMN SON OCODOANMMNAWN = DOWOOMAIODUWMBWN-, OW) 

oO 
oO 
wo 
_— 


Www 
a bPeene 
OoON HUT 


00A8 


OOAC 


OOF O 


0100 


0101 


0104 


0105 


O1lE 


0000 
0008 
0078 
007C 
0090 
0092 
0094 


be ee ee ee ee be ee ee ee ee be ee ee et ee ee be Be ee be et ee eb be be be ee be ee be eb be be Re be ee ee be be be et be me ee be be bb be be be eb ee be he 


Phe RWWW WWW WW OW OO WO WW GIO WW WII WWW WWW WDWWWWHOWWWWWWODWWW WW WLW 
DODOWO WOO WO WO OC © © © CO © 0 CH © OW OO DWAIN SENSI ND AMNMMAIAMAHMAMHMMNMNATNANNA NN oN 
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2? 
2? 


272222272 


2? 


?? 


02 


03 


19 


( 


?? 


2? 


7? 


a 


2? 


2? 
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S40 EGA INFO] db ? ; 040.0087 EGA miscellaneous information 
$40 _EGA_INFO2 db ? ; 040:0088 EGA miscellaneous information 

Reserved 

db 2 dup (7?) , 040.0089 

; Aas disk rate area 
$40 FLOPPY LAST RATE db ? ; 040:008B last floppy data rate selected 
; Additional fixed disk data area 
$40 AFD STATUS REG db ? , 040:008C fixed disk status register copy 
S40 AFD_ERROR REG db ? . 040:008D fixed disk error register copy 
S40 AFD_INTR_ FLAG db ? , 040:008EF fixed disk interru flag 
$40 _AFD_CTRL_ FLAG db ? , 040:008F fixed disk Eonttoliee flag 


, Additional ope diskette data area 
$40 _AFLOPPY MEDI db 


- ? ; 040:0090 drive 0 media state 
S40 AFLOPPY MEDIAL db ? , 040:0091 drive 1 media state 
S40 AFLOPPY OPERO db ? , 040 0092 drive 0 operation state 
S40 _AFLOPPY OPER] db ? 040:0093 drive 1 operation state 
S40 _AFLOPPY TRACKO db ? 040°0094 drive 0 current track 
S40 AFLOPPY TRACK} db ? ; 040.0095 drive 1 current track 
S40_AFLOPPY RESERVED db ? ; 040:0096 floppy disk reserved byte 
; Keyboard LED data aroa 
$40 KBO_LED_ FLAGS db ? 040:0097 keyboard LED flags 
> Real-Time clock data area 
S40_ RTC WAIT OFFSET dw ? 040:0098 offset address of user wait flag 
S40 RTC WAIT SEGMENT dw ? 040: 009A segment address of user wait flag 
S40 RTC WAIT CNT _LOW dw ? 040:009C low word of wait count 
S40 RTC WAIT CNT HIGH dw ? 040:009E high word of wait count 
S40_RTC WAIT ACTV_FLG db ? 040:00A0 wait active flag 
, Reserved 
db 7 dup (7) , 040:.00A1 
, Pointer to EGA data area 
S40 _EGA_TBL_PTR dd ? - 040.00A8 pointer to table of EGA pointers 
; Reserved 
db 68 dup (7) ; 040:00AC 


; Intra-application communications area 
S40 INTRA_APPL db 16 dup (7) ; 040:00F0 available to any application 


Print screen status 


S40_PSCRN STATUS db ? ; 040:0100 flag for print screen in progress 


Reserved 
db 3 dup {?) , 040:0101 


DOS data area 
S40 SINGLE DRV_STAT db ? , 040:0104 status of floppy for single floppy 


: systems, ie currently drive A: or B 
- Reserved 


db 25 dup (7) ; 040:0105 


SEGMENT40 ends 


OOOO OOOO OOO OOO IO OO OI OOOO OR OOK IOHOIOg KK 
: STO-BIOS table addresses 


S40 RS232 PORT TBL equ word 


- * a, ptr $40_RS232_ PORT! AOR 

$40 PRINT PORT TBL equ word ptr S40 PRINT_PORT1 ADR 

S40 PRINT TIMEOUT TBL equ byte ptr S40 PRINT TIMEOUT1 
$407RS232_TIMEOUT_TBL equ byte ptr S40 RS232 TIMEOUTI 

S40_AFLOPPY MEDIA equ byte ptr S40_AFLOPPY MEDIAO 
S40_AFLOPPY_OPER equ byte ptr S40 AFLOPPY_OPERO 

S40 AF LOPPY TRACK equ byte ptr S40 AFLOPPY TRACKO 
BAO OO OOOO IOS OOO OOO OOO AGITIO ASAIO ODIO OOO ITE IIASA AIO 


page 


5 IRR RRR KKK KKK KKK KHOR KKK RK KKK ORR RK RK KOR KK OK KK KKK KR KKK KKK KKK KK 
; S40 EQUIPMENT FLAG word 
OOOO OOOO a OOO OR OO IOR OR IORI IO mar II IOI III IOI III 1K 0K 


pm ee ee et pee fe ee be be te he fee ee be ee ae eee ee ee be ee in pn ee be ee be ee ee ee ee et ee ee ee ee ee he be ee be me be be ee ee ee be bm bm bo be be rm 
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Equates File (continued) 


1404 : FEDCBA9876543210b 

1405 = C000 S40E DEVICE PRINTRS equ 1100000000000000b - number of printers 

1406 » OE00 S40E_ DEVICE RS232 equ 0000111000000000b ; number of Rs232 ports 

1407 = 00C0 S40E DEVICE FLOPPY equ 0000000011000000b ; number of floppy drives 
408 =» 0030 S40E DEVICE VIDEO equ 0000000000110000b * initial video mode 

409 e 0002 S40E DEVICE MATH equ 0000000000000010b . 80287 installed 

410 = 0001 S40E DEVICE BOOT equ 0000000000000001b floppy boot device present 

ree Seri restristroceretrerttreretettetettestertetet ie tres nets t ss. XXXKKKKKKKKAKKKX 
1 ‘ 

413 Bit Value Definition 

414 F-E 0 no printers installed 

415 1 one printer installed 

416 2 two printers installed 

417 ; 3 three printers installed 

418 i 0-C cone reserved 

419 B-9 0 no RS-232 ports installed 

420 1 one RS-232 port installed 

421 2 two RS-232 ports instailed 

422 3 three RS-232 ports installed 

423 4 four RS-232 ports installed 

424 8 2S si reserved 

425 7-6 0 l floppy diskette drive installed, iff bit 0#1 

426 1 2 floppy diskette drives installed, iff bit 0O#=1 

427 5-4 1 initial video mode of 40-column color 

428 2 initial video mode of 80-column color 

429 3 initial video mode of 80-column monochrome 

430 3-2 ---- reserved 

431 1 0 math coprocesor not present 

432 1 math coprocessor present 

433 0 0 no diskette drives present 

434 : 1 some number of floppy diskette drives present, 

43 ; see bits 7-6 

43 

43 ack 

43 bi RXKKAKKKAKAAKKAKAAKAKAAAA KAKA KAKAKAKAKAKAAAKAAKAKAKAKAAKAKAKAAAKAKAARKAKAAAKAAKAAAKAKAAKAKAAKAKKE 
43 : he le LEOS $40 _KBD_LED_FLAGS 

44  KXKKKKKKK KK KK KKK AK KAKA KAKA AK KAKA AK KKK KK AKAKK AKA KAKAKAKKAAKA KAA KAKKRKAKAKAKAKKAAAKAKAAAKAKAKKAKAKA 


76543210b 


» 0004 40F KBD_LED_CAPS equ 00000100b ; caps lock LED state 
=» 0002 S40E KBD LED NUM equ 00000010b : num lock LEO state 
e 0001 S40E KBD LED SCROLL equ 00000001b - gcroll lock LED state 
(TART AAT RAEI TEAR THLE AAA TREES AH A HAMA IATA HAHAHAHAHA AAT 
Bit Value Definition 
7-3 coce reserved 


<Caps lock> LED is off 
«Caps lock> LED is on 
<Num lock> LED is on 
CNum lock> LED is off 
<Scroll lock> LED is off 
«Scroll lock> LED is on 


UINIQOOOOIOIOOOOIO A ORIOO GIO ’nIORIAO IO OIOOOSOOIOOIOR AIO IO IO IO III TORII IKK 
; KHXKKKKKKK KKK KK AAA AKA KAKA AK AKA AK KAKA KKK AKA KAK KK AKA KAAAKAKAAKAAAEAKAKAKKKAKAAKKKAAKK KAKA KK 


; $40 _ KBD _STATE1 
I ee Se a EAGER ee 
654 


Oo - — 
-Orf Oro 


3210b 
=» 0080 S40E KBD ST1_INSERT equ 10000000b ; insert mode state 
= 0040 S40E_ KBD ST1_ CAPS equ 01000000b , caps lock mode state 
= 0020 S40E_ KBD _ST1_NUM equ 00100000b > num lock mode state 
# 0010 S40E KBD ST1 SCROLL equ 00010000b - gcroll lock mode state 
2 0008 S40E K8D ST1 ALT equ 00001000b - alt Bey state 
2s 0004 S40E KBD ST1 CTRL equ 00000100b ; control key state 
=» 0002 S40E KBD STL LSHIFT equ 00000010b ; ae shift key state 
» 0001 S40E KBD ST1_ RSHIFT equ 00000001b ht shift key state 
MER oO 00g gogo OOo 000 OOOO TIO KXKKKKKKAAKKEKAKKKKAKAAKKKKE 
j Bit Value Definition 
: 0 insert state inactive 
‘ 1 insert state active 
: 6 0 caps lock state inactive 
: 1 caps lock state active 
5 0 num lock state inactive 
1 num lock state active 
4 0' scroll lock state inactive 
1 scroll lock state active 
3 0 <Alt> key not depressed ee ada 
1 <Alt> key depressed (act 
2 0 <CTRL> key not depressed (inactive) 
1 <CTRL> key depressed (active) 
1 0 left <Shift> key not depressed (inactive) 
1 left <Shift> key depressed (active) 
0 0 right <Shift> key not depressed penecteved 
; 1 right <Shift> key depressed (active) 


AIOE OOIO IO ION IDIAIIO IO IOI IOO ASIII III IR INC IORI IRI IIIO R 


KKK KKK ERK RH KAKA KKK KKAKA KKK KKK AAK KKK KAKAKAKAKAKAAKKAKAKAKKAAKAKAKAAKAKAKKKAAAKAAAAAKAK KKK 
; $40 _KBO_STATE2 
KKK KEKKREKK KAKA KK AKA KKK KAKA AAA AKA AK KAKA AAA KAKA AKAAKKAAKKKKAKAKAAKAKKAKKKKAKAKAKAKEKKAKK 


ONMOVEWNE OW DNDN AWNH OW DNA EWN OW DYUHNAWN HOD DNAUW AUN OO DONAU AWN OW TN OW 


76543210b 
= 0080 S40€ KBD ST2_INSERT equ 10000000b : insert key state 
s 0040 S40E KBD_ST2_ CAPS equ 01000000b ; caps lock key state 
= 0020 S40E KBD_ST2_NUM equ 00100000b ; mum lock key state 
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Equates File (continued) 
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0010 
0008 
0004 


00C0 
0020 
0010 
0007 


ee ae ee a oo a a ee Ne ed ol one 
AMNUWNUGAUWUNAON UA NON AUTO ONO UFO ON UT UT Un UF On UI UT Un OT UT UN UN 
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00CO0 
0020 
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0007 
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WD / |W © 69 09 00 00 CO 00 09 9 OO NEI NINN IO DMOMMMMOMMAMMOMUIMNUIUT AMUN Shah ESR HRWWWWWW 
asaesnes 
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oornA) co 
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Db be be be be eee tn a fe ie pee ee be ae be be ee ee be be ee ee be bt ee be be he be be ee ee ee ee et ee ee be be be be be be be 
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S40E_ KBD_ST2 SCROLL equ 00010000b . scroll lock key state 
S40E KBD ST2 PAUSE oa 00001000b padre (<CTRL>-<«Numlock>) state 
S40E_ KBD ST2 SYSREQ 00000100b req key state 
211 TIGER JOR OOOO DOO IO IORI 
: Bit Value Definition 
: 7 0 <Ins> key not depressed 
: 1 (Ins> key ag Aiea 
: 6 0 ‘Caps lock> key not depressed 
: 1 «Caps lock> key depressed 
: 5 0 <Num lock> key not depressed 
: 1 <Num lock> key depressed 
; 4 0 <Scrick> key not depressed 
: 1 <Serlck> key Se eda 
: 3 0 pause state (<CTRL>-<Num lock>) inactive 
1 pause state active 

2 0 «Sys req> key not depressed 
; 1 «Sys req> key depressed 
: 1-0 712° reserve 


IA OOOIOOOO OOOO OOO OOOO OSO OOOO OOO SEOI COORG O IT’ OO CIO IO RII 
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76543210b 
S40E MEOIAO RATE equ 11000000b > drive 0 data transfer rate 
S40E MEDIAO STEP equ 00100000b - drive 0 seek step nt 
S40E MEDIAO KNOWN ee 00010000b , drive 0 media reshe f ey 
S40E MEDIAO TYPE 00000111b ; drive 0 media typ 


Pe AS TT ett Ter T eee eT ee rer mera La eneT Te ree 
. S40_AFLOPPY MEDIAI 
KKK KKK HR KK RH RR ROK MR RK KR HK RK KOK KK KK KR KK RK 


76543210b 

$406 MEDIAL RATE equ 11000000b . drive 1 data transfer rate 
S40E MEDIA] STEP equ 00100000b - drive 1 seek step nt 
S40E MEDIAL KNOWN equ 00010000b - drive 1 media known f . 
S40€ MEDIAL TYPE equ 00000111b - drive 1 media type fi 
Hand 0000 oo npnoHE 20d 0dO000 dO EE EEO OE 

Bit Value Definition 

7-6 0 data transfer rate is S00kb/sec 


data transfer rate is 300kb/sec 

data transfer rate is 250kb/sec 

single step all seeks 

double step all seeks 

type of diskette in drive unknown 

type of diskette in drive known 

reserved 

attempting 360k diskette in 360k drive 
attempting 360k diskette in 1.2mb drive 
arene 1 2mb diskette in 1.2mb drive 
determined 360k diskette in 360k drive 
determined 360k diskette in 1.2mb drive 
determined 1.2mb diskette in |L.2mb drive 
ego gn dada SOO GOIDIIOIOOI IOI AAIOIOOI GOGO OOO IOOIOOIOOIOOI TOO OCA OIC III 


OM WRH OH OMr ONE 


PICO Sa S On AOAC INO IACI AOOI ISCO IAI OO III IOI IOI III IIIA III 

; $40 FLOPPY_RETURN STAT 

JERE AERTS ERAS RA ANE SES ASSIA REAA STATA ADE DA SRERSSE SN EES EEA ERERESEEDIE REINS RAN EARE 
43210b 

S40E FLOPPY _RSTAT TMO equ 10000000b ; timeout error flag 

S40E FLOPPY RSTAT SEEK equ 01000000b ; seek error flag 

S40E FLOPPY _RSTAT CTRLR equ 00100000b ; controller error flag 

S40E_ FLOPPY RSTAT_ERR equ OOO0L1I11b ; error code field 

20 OI IIIT IT TTT TTT LT TT ITED TT TT DT TT ET TET TT TIT IT 


Bit Value Definition 
timeout error, diskette failed to respond in time 
seek error; seek to track failed 
controller error: diskette controller chip failed 
bad command, invalid command request 
address error: address mark on diskette not found 
write protect error 
sector not found: unable to locate sector, diskette 
damaged or unformatted 
media changed; the drive door was opened 
on a 1l.2mb diskette drive 
OMA error; DMA failed to respond in time 
segment wrap; attempt to perform DMA accros 
a segment boundary 

0 CRC error: cre check on data failed 


me NeD~ 


—_—- Oc @o BUN Ree 


' 
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’ 
‘ 
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' 
p 


POSS SIS OIE OO OOOO OOOOOEDI SOOOCOOOL I IT 
: $40 FLOPPY MOTOR STAT 
| 8880 add Bn BERTI TTI TIT T TTI ATP 


6543210b 
$40€ FLOPPY MOTR WRITE equ 10000000b write operation flag 
S40E_ FLOPPY MOTR SELCT1 equ 00100000b ; drive one select flag 
S40E FLOPPY MOTR SELCTO equ 00010000b ; drive zero select flag 
S40E FLOPPY MOTR RUNI equ 00000010b ; drive one motor flag 
S40E_ FLOPPY MOTR_RUNO 00000001b : zero motor fla 


dr 
LS TTT TS TT Tee TET Ter Ter Tere eT ees KKXXEKKK 


rr 


a a ne a a ee ee ee ee ee en Nd ed cd ol ol os 
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quates File (continued) 


; Bit Value Definition 
7 current operation is not a write 
: 1 current operation is a write 
: 6 meee reserved 
: 5 0 drive one in not selected 
: 1 drive one is selected 
: 4 0 drive zero is not selected 
; 1 drive zero is selected 
3-2 wee reserved 
F 1 0 drive one motor is not running 
: 1 drive one motor is running 
0 0 drive zero motor is not running 


: 1 drive zero motor is runnin 
: KXKKEKKKAKAKKKKKKAKAKEKKAAKKAKKKKAKKAKKKAKKKAKAKKKKKAKKKKKAKAKKEKAKKAKAKKKAKAKKAKKKKKKAKKAKAKKKKKKXK 


; RXKKKAKAKAKAKKKAAKKKKAKAKAKAKAKAKAAKAAAAKAKAAAKAKKKKAAKAKAAKAAKKAKAKAKKAKAAKAKAAKAKKAAKAKKAKKKAKAKKAKAKAKAKKK 

; $40 FLOPPY SEEK STAT 

, CEEREREREDE VRREET SEER GCRSAREN TEE EC ERA ANNE R TT eee ERB CeO ACR EESESENEEEESSY34® 
765432106 


» 0080 S40E FLOPPY SEEK INT equ 10000000b > interrupt occured flag 
= 0002 S40E FLOPPY SEEK RECAL1 equ 00000010b ees one recalibration flag 
» 0001 S40E FLOPPY SEEK RECALO equ 00000001b ; drive zero recalibration raed 
JASE ODO EOE OOOO OT TE TET TTR ATI 
d tas Value Definition 
: 1 diskette hardware interrupt occured 
; é- 2 weet reserved 
1-0 0 indicates corresponding drive (1 or 0) needs 
recalibration before next seek 
1 indicates corresponding drive (1 or 0) does not 
need recalibration before next seek 
Ue god aS SIGS AO NIA IAOAONIIO OOOO ISO IORIOOIOOIGO IOSD IOOIDO IORI DORIOI OI IOI 
END 
Macros. 
Name Length 
MSD HEADER 0006 
POPPF. . 0003 
SYSCALL. 0004 
Structures and records 
Name Width ® fields 
Shift Width Mask Initial 
DESCRIBE . 0030 0018 
D_SOURCE . 0010 
D_HPHIL ID . 0011 
D_ DESC MASK. 0012 
p-i0 MASK. 0013 
D_XDESC MASK 0014 
Davee AXIS . 0015 
D CLASS. . 0016 
D_ PROMPTS. 0017 
D RESERVED 0018 
DO BURST LEN. 0019 
D WR REG OO1A 
pal “REG... 001B 
D TRANSITION 001C 
D STATE. 0010 
OD RESOLUTION OO1E 
O SIZE_X . . 0020 
DO SIZE Y 0022 
DO ABS X 0024 
D_ABS_Y 0026 
OD REL X. 0028 
pene Yo 9 002A 
D ACCUM X. 002C 
D ACCUM Y et ee Oe ee, es Ae B O02E 
HP GLB HEADER. sd elke OG 0060 0013 
ee HEADER. — ees 0000 
T_USED_AND RESERVED. bed 0002 
T HP _LAST_ DS a eas OO0E 
T HP MAX BS... ead Ye gk un ae 0010 
T HP NXT VCTR. 0012 
T SND_FLAG . 0014 
eee COUNT. 0015 
T SND_CLICK DURA 0016 
T_SND_ CLICK VOLUME 0017 
T_SND BEEP CYCLE 0018 
T_SND_BEEP_DURA. OO1A 
T_SND_ BEEP COUNT 001c 
T STR_NEXT_INDEX ... . . . . .. OO1E 
T_STR_ROOT . By eA 0020 
T STR _VCT _HDR. 5 ak ted os th abe tt 0024 
yoele MSG HDR ........, 0032 
8255 FLAGS ........., 0040 
HP SHEADER ob hac, tes 26, e. oh pee 0010 0009 
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Equates File (continued) 


DH ATR . . 
DH NAME INDEX. 
DH V_DEFAULT 
DH_P-CLASS . 
OH7C CLASS . 
DH_V_ PARENT 
DH V_CHILD 
DH” MAJOR 
DH MINOR . . 
HP TABLE ENTRY 
HP ENTRY _ IP. 
HP ENTRY CS 
HP-ENTRY_DS. 
LDESTRIBE ~. 
LD SOURCE... 
LO”HPHIL_ID 
LD DEVICE_ STATE. 
LD-INDEX . . . 
LD MAX AXIS. 
LD CLASS . 
LD PROMPTS . 
LD RESERVED. 
LDRES2 
LD" RES3 
LD -RES4. 
LO TRANSITION. 


De ee ee 


LD-REL_Y 
LD_ACCUM_X 
LDACCUM_Y 

MSO INIT CMD . 
MSD_UNIT COUNT 
MSD_END OFFSET 
MSD_END SEG... 
MSD BPB OFFSET 
MSD_BPB_SEG. 
MSD_1ST_UNIT 

MSD_I0_CMD 
MSD YFER OFFSET. 
MSD_XFER SEG . . 
MSD_XFER7 COUNT 
MSD~1ST BLK. 
MSD_VERR SEG 

MSD _REQ HEADER 
MSD_CMDLEN 
MSD_UNIT 
MSD_CMD 
MSD STATUS 
MSD_MEDIA. 


MSO_TRANS. 

MSD COUNT. 

MSO START. 
SEGMENT4O. 


S40 _RS232 PORT1 ADR 
~PORT2_ADR. 
~PORT3_ADR. 

S40_RS232_PORTG ADR. 


S40 ~RS232 
S40_RS232 


$40 
$40 
$40 
$40 
S40 EQUIPMENT FLAG 
S40 MFG INIT ‘ 
S40 MEMORY SIZE. 
S40 MFG _ ERR FLAG]. 


PRINT 
PRINT PORT3_ADR 


PORT ADR 
$40 
$40 
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ecooo00000000 
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PORT1_ADR. 
PRINT PORT2 ADR. 


PRINT PORT4 ADR. 


oooooooo°o°o°o°coeo 
oooooo0°0o000o00o 
Ca) bb pee ee be be ee be 
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CURSOR MODE . 
DISPLAY PAGE 


0003 


0017 


0007 


0006 


000A 


0057 


Equates File (continued) 


$40 XROM_INIT_ADR. . . .... . 0067 
S40_XROM SEGMENT . . . 1... . . 0069 
S40 XROM_INT FLAG. ...... . 0068 
S40 TIMR LOW... ...... . 006C 
S40 TIMR HIGH. ee ae eH OO6E 
S40 TIMR OVR FLOW. ...... . 0070 
$40 SYS BREAK FLAG. ..... . 0071 
S40 SYS RESET FLAG. ..... . 0072 
$40 FO STATUS. ........ . 0074 
$40 FO COUNT. ........ . 0075 
S40 FD CONTROL. ........ 0076 
S40 FO PORT OFFSET ...... . 0077 
S40 PRINT TIMEOUTL ...... . 0078 
S40 PRINT TIMEOUT2 ...... . 0079 
S40 PRINT TIMEOUT3 ...... . OO7A 
S40 PRINT TIMEOUT4 ...... . 0078 
$40 RS232_ TIMEOUT] ...... . 007C 
S40 _RS232 TIMEOUT2 ...... . 007D 
$40 RS232 TIMEOUT . © 1h oho OO7E 
S40 RS232 TIMEOUT4 . QO7F 
S40 KBD BUF START. eS it oe eg, “& 0080 
$40 KBD BUF_END......... 0082 
S40 EGA_CRT ROW CNT... ... . 0084 
S40 EGA CHAR SIZE. 0085 
S40 EGA_INFOI. ......... 0087 
S40 EGA _INFO2.......... . 0088 
S40 FLOPPY LAST RATE . es ee 0088 
S40 AFD STATUS REG... ... . 008C 
S40 AFD ERROR REG. by eres WL ae rt 008D 
S40 AFD _INTR FLAG... .... . OO8E 
S40 AFD CTRL FLAG. . Bo wtp id aie 008F 
S40 AFLOPPY MEDIAO 3 0090 
S40 AFLOPPY MEDIAL . . Bt ies 0091 
S40 AFLOPPY OPERO. .. .. . . . 0092 
S40 AFLOPPY OPER)... .. . . 0093 
S40 AFLOPPY TRACKO ...... . 0094 
S40 AFLOPPY TRACK} (Gin Bee «Hee FES 0095 
S40 AFLOPPY RESERVED... .. . 0096 
$40 KBD_LED FLAGS ....... 0097 
S40 RTC WAIT OFFSET. ..... . 0098 
S40 RTC WAIT SEGMENT . . fs 009A 
S40 RTC WAIT CNT LOW... .. . 00g9c 
S40 RTC WAIT CNT HIGH. .... . OO9E 
S40 RTC WAIT ACTV_FLG. .... . 00A0 
S40 EGA TBL_PTR. ~ . Se ean, 2 00A8 
S40 INTRA APPL... ... .. ., OOF O 
$40 PSCRN STATUS . a et ee 0100 
S40 SINGLE DRV_STAT...... . 0104 
STR HEADER. .. .. ss OOOE 0005 
STR NXT HOR... . Be Oe 0000 
STR UPPER BOUND... ..... . 0004 
STR LOWER BOUND. ....... ., 0006 
STR LIST PTR. ........., 0008 
STR SEGMENT... . . . . 2 000C 
VIDEO DATA i de ee a ae ees 0040 000D 
VIO_ATR . . gt wae ne Be yh By oul a 0000 
VIO NAME _INOEX . . . . . 2... 0002 
VID_V_DEFAULT >, 3 ae 0004 
VID PRIMARY. bos iy os 0006 
VID_SECONDARY ©... . 2 . 0007 
VID_FOUND_ROM .... . . 2. 0008 
VID_IDS i oe es be iS ee, ae 0009 
VID STATUS > tock: “fae . te: 4 0000 
VID EXT STATUS te ee eo 0011 
VID PARM BLOCK | Be ss vi 0015 
VID LAST IBM MODE. e eit, te os 003C 
VIO_EXT MODE Los — 0030 
VID_ PADDING . og & 8 OOJE 
Symbols - 
Name Type Value Attr 
ATR 0 h aide 4 a ee Number 0001 
ATR BOT a te ties ; me ie Soe Number 0QA00 
ATR CSHARE . . . . . 2. 2 Number 0008 
ATR DEVCFG. .. . .,. . ... bs 4g Number 4000 
ATR ENTRY BS cha ee we Ware? eee oe Number 1000 
ATR FREE aoe a a OS ; Number 0200 
ATR HP on & it ay ae Number 8000 
ATR IND . 5 see eas a> Gd 48 Number 0800 
ATR_INP. i a Number 0CQ00 
ATR ISR. i ee Number 2000 
ATR LOG a ¢ & of Number 0600 
ATR MAJOR eM oe Number 0020 
ATR MAP CALL Lg coe Number 0080 
ATR MID . Number 0060 
ATR MINOR are i 4 Number 0040 
ATR NOADDR a we oe Number 0000 
ATR PSHARE 2 aes & % Number 0010 
ATR ROM -_ Number 0004 
ATR RSVD Ra i 6d Number 0000 
ATR SRVC aS Number 0400 
ATR STRING... . ck Boe Number 0100 
ATR SUBADD Sorte gcd at ua iets Number 0060 
ATR TYPE? dp Aah Oe a he ws Be f Number 0O£€00 
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Equates File (continued) 


ATR_TYPE MASK. 
ATR-YIELD. 
BUTTON ERROR 
CLASS ASCII 
CLASS BINARY 
CLASS GIDCCP 
CLASS JOY. . 
CLASS_KBD. 
CLASS_KEYPAD 
CLASS MOUSE | 
CLASS PADDLE 
CLASS_TABLET 
CLASS THUMB. _ 
CLASS _TRACKBAL 
CLASS-TS . 
CLASS_UNDEF8 . 
CLASS _UNDEFD 
CLASS_UNDEFE 
CLASS_UNDEFF 
CLIP ENABLED 
CLA or 


Le ee ee | 


CON... 
CLUEXTEND. 
CLIFILT. . 

CU GID). Jo. 
CL_INTERFACE 
CL7KBD 

CL-KBDFC 
CLLGID. 

CL_NULL 

CL PGID 

CL PTS 
DESCRIES SIZE. 

D ADDR MASK. 

D BUFFER 

D-CCP STATE . 
D-CLASS CURRENT. 
D “CLASS DEFAULT 


rt fete 


Peters ttt 


D REMAINDER ACCUM. 
O° SAMPLE ABSOLUTE. 
D SAMPLE RELATIVE. 


D SIZE 7. 
D™TYPE MASK. . 
VENT ENABLED. 
0 GET INFO 
"GET_RES. . 
“GET STMODE 
INQUIRE. 
MOD_ INFO 
RD THARATR 
RD CURPOS. 
RD” PENPOS. 
RD-PIXEL . 
SCROLL_ON. 
SCROLL UP. 
SET CURPOS | 
ET CURSIZE. 
ET-INFO.. 


‘ 


ee ee ee 


~XSET MODE. 
“ALT RESET 
“CHG” STATUS 
FORMAT FLEX 
FORMAT HDISC 
“GET DASD 
“GET HPARMS 
“RD LSTATUS 
RD SECTORS 
RESET DISC 
SET DASD 


i | 


TRACK SEEK 
VR SECTORS 
WR” SECTORS 
EXINIT 
G 
I 
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PUT BUFFER 


STATUS 
TRM_BUFFER 
MIT 


BLOCK MOVE | 
DEVICE CLOSE 
DEVICE _OPEN. 
DEV BUSY . 
ENTER PROT. 
ET XMEM SIZE. 
NT_COMPLETE 
OYSTICK . . 
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AIT_EVENT 
EF ATIR . . 
EF MAPPING. 
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ET MAPPING. 
NQUIRE. .. 


KBD_RESET. 
KEY STATE. 
SETLATTR |. 
SET MAPPING. 
SET_XLATORS. 
TATUS . 

ET BUFFER 

NIT 


NQUIRE. . 
UT BUFFER 
“PUT_CHAR |. 
READ STATUS. 
STATUS. 
TRM BUFFER 
GET_DATE 
GETTRTIC. . 
RO CLK CNT . 
RESET ALARM. 
SET ALARM. . 
SET CLK _CNT. 
SET_DATE . 
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FLA 
FLA 
FAA 
FIA 
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3_DISABLE. 


EN 

ENABLE LIGHT 
GRAPH cue On 
I 
I 


“MOTION 
—_PUT_CURSOR 
“RATIO... 
~REPORT _DATA. 
EPORT PRESS 


EXT CURSOR. 
TEND GCSR 
S GET 
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EEGLBDS. 
REEOWNDS. 
XCHGF IX. 
S_XCHGFREE 
S_XCHGRSVD 
CONTROL 


PUT BLOCK. 
PUT BUFFER 
PUT BYTE 
F PUT SPRITE 
F_PUT WORD 
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F_PUT_ BUFFER 
OD0A 
0006 
0010 
OOO0E 
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Equates File (continued) 


F RAM GET. 
F_RAM RET. 

F REMOVE SPRITE. 
F_REPORT ENTRY 
F SAMPLE 

FSET LIMITS X 
FSET LIMITS_Y 


F SND_BEEP_DISABLE 


F SND BEEP ENABLE. 

F SND CLICK. 

F SND CLICK _DISABLE. 

F SND CLICK ENABLE 

F SND SET BEEP ; 

TONE . . 

F_STR_ DEL BUCKET 

F STR GET FREE INDEX 

F STR GET INDEX... 

F_STR_ GET STRING 

: STR PUT BUCKET 
SYSTEM |. . 

f TRACK INIT 

F TRACK OFF. 

F TRACK ON 

F YIELD. 

GID_A08. 

GID Al6. 

GID_RO8 

GID R16. 

GID UNDEF . 

HP ENTRY . 

INDX BARCODE 

INDX BOOT ERROR _MSG. 

INDX DRIVE A 

INDX DRIVE B 

INDX DRIVE C 

INDX DRIVE D 

INDX DRIVE E 

INDX ORIVE F 

INDX DRIVE G 

INDX ORIVE H 

INOX DRIVE I 

INDX DRIVE ? 

INDX DRIVE 

INDX DRIVE t 

INDX DRIVE M 

INDX DRIVE N 

INDX DRIVE 0O 

INDX DRIVE P 

INDX DRIVE Q 

INDX DRIVE R 

INDX DRIVE S 

INDX DRIVE T 

INOX DRIVE U 

INDX DRIVE V 

INDX DRIVE W 

INDX DRIVE X 

INDX DRIVE Y 

INDX DRIVE Z 

INOX HP COPYRIGHT | 

INDX INVALID ROM MSG 

INDX KEYBOARD. . 

INDX KNOB. 

INDX KYB LOCKED MSG. 

INDX_ MOUSE 

INDX RETRY MSG 

INDX SETUP MSG 

INOX STRIKE _F1 MSG 

INDX TABLET |. 

INOX TOUCH 

INT 8041 OBF 

INT BOOT 

INT BREAKPOINT 

INT BREAK EVENT. 

INT CLOCK 

INT DISC 

INT DIVIDE ZERO. 

INT DOS. 

INT EQUIPMENT. 

INT FLOPPY DIRECT. 

INT FLOPPY PARMS . 

INT GRAPHICS CHAR. 

INT HDISC PARMSO 

INT HDISC PARMS] 

INT HPHIL . 

INT HPMOUSE . 

INT IRQO_TIMER 

INT IRQ! KBD_ISR 

INT IRQ2 

INT IRQ3 SERIAL] 

INT. _IRQ4 SERTIALO 

INT IRQS PRNI. 

INT IRQ6 FLOPPY. 
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Equates File (continued) 


INT IRQ7_ PRNO. 


INT 
INT MEM SIZE 
INT NMI. . 
INT OVERFLOW 
INT PRINTER. . 
INT PRINT SCREEN 
INT RTC EVENT 
INT_SERTAL 
INT SINGLE STEP. 
INT SVC_ REQUEST. 
TEM . 
INT TIMER TICK 
INT VIDEO... . 
INT VIDEO PARMS. 
IRQIO. 
IRQL1. 
IRQI2. |. 
IRQL3 287. 
IRQ14~HDISC. 
IROIS. 
IRQ8B RTC 
IRQS_REDIRECT . 
ISR_IN PROGRESS. 
LDESCRIBE SIZE 
LO BUFFER. . 


LD CLASS CURRENT 

LD CLASS DEFAULT . 
LD-REMAINDER ACCUM 
LO RES MASK 
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ee | 
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LO SAMPLE ABSOLUTE 
LD SAMPLE RELATIVE 
LO SIZE. th 
LD TYPE MASK 
MSD_BAD _DCHG 
MSD_BAD_LENGTH 
MSD_BLD_BPB_. 
MSO_CRC_ ERROR. 

MSD DEV CLOSE 

MSD DEV_OPEN 
MSD_DONE_ STATUS. 
MSD_ERR STATUS . 
MSO_GEN FAILURE . 
MSD_INIT . 
MSO_INPUT. 
MSD_IN FLUSH . 
MSO_IN_NOWAIT. 
MSD_IN STATUS. 
MSO_IOCTL_IN | 

MSO IOCTL OUT. 
MSD_MEDIA CHK. 
MSO_NOT READY. 
MSD_OUTPUT _ 
MSD_OUT FLUSH. 
MSD_OUT_STATUS 
MSO_OUT_VERIFY 
MSD_PAPER OUT. 
MSO~READ FAULT 
MSD_REM MEDIA. 

MSD_ SEC NOTFND 

MSD SEEK ERROR 
MSD_UNKNOWN CMD. . 
MSD UNKNOWN MEDIA. 
MSD_UNKNOWN_UNIT 
MSO_WRITE FAULT. . 
MSD _WRITE_ PROTECT. 
RS BAD PARAMETER 
RS BREAK cot 
RS_BUSY. 
RS_DATA_NREADY 

RS DONE... . 

RS FAIL. 

RS FRAME 

RS- NOT SERVICED. 

NO VECTOR 
S_OFFLINE . 

OUT OF PAPER. 
OVERRUN | 
PARITY. . 

RS SUCCESSFUL. 

RS TIMEOUT 

RS UNSUPPORTED . 
S40E_ DEVICE BOOT 
S40E DEVICE FLOPPY 
S40E DEVICE MATH 
S40E DEVICE 
S40E DEVICE 
S40E DEVICE 
S40E FLOPPY 
S40E 
S40E 
S40E 
S40E 
S40E 


Ir 


iJttott ta 


RS 
RS 
RS 


RS232 
VIDEO 


PRINTRS. 


MOTR RUNO. 
FLOPPY MOTR_RUN1. 
FLOPPY MOTR SELCTO. 
FLOPPY MOTR SELCTL. 
FLOPPY MOTR WRITE | 
FLOPPY_RSTAT CTRLR. 
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LD_RESOLUTION 
0OFO 

OOOF 

LD _ACCUM_X 
OOOF 


LD_ABS X 
LD_REL_X 
LD-SIZE_Xx 
0OFO 
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Equates File (continued) 


S40E_ FLOPPY _RSTAT_ERR. 
S40E FLOPPY _RSTAT SEEK 
S40E_FLOPPY_RSTAT_TMO. 
S40E FLOPPY SEEK INT 
S40E 
S40E 
S40E KBD_LED CAPS. 
S40E_KBD~LED_NUM . . 
S40£ KBO_LED SCROLL. 
S40E-KBD_ST1_ALT . 
S40E_KBD_ST1 CAPS. 
S40E KBD ST1_CTRL. . 
S40E_KBD_ST1_ INSERT. 
S40E_KBD_ST1~LSHIFT. 
S40E_KBD_ST1_NUM . 
S40E KBD _ST1_RSHIFT. 
S40EKBD_ST1 SCROLL. 
S40E_KBD_ST2_CAPS. . 
S40E KBD_ST2_~INSERT. 
S40E_KBD_ST2_NUM . 
S40E KBD_ST2 PAUSE | 
S40E_KBD_ST2 SCROLL. 
S40E_KBD_ST2_SYSREQ. 
S40E MEDIAO KNOWN. 
S40E MEDIAO_RATE 

S40E MEDIAO STEP 

S40E MEDIAO TYPE . 
S40E MEDIAL KNOWN. 
S40E MEDIAL _RATE 

S40£ MEDIAL STEP 

S40E MEDIAL TYPE . 

S40 AFLOPPY MEDIA. 
S40_AFLOPPY_OPER . 
S40_AFLOPPY TRACK. 
S40_PRINT PORT TBL . . 
S40 PRINT TIMEOUT TBL. 
S40-RS232 PORT TBL .. 
S40_RS232 TIMEOUT TBL. 
SF CLIPPING OFF. ~ . 
SF~CLIPPING_ON 
SF-CLOSE . ~ 
SF_CLR_CRTSW 
SF_CLR_RAMSW 


a 
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SF 
SF_CRV_RECONF IGURE 
SF CRV_REPEAT. . 
SF_CRV~REPORT NAME . 
SF _CRV_REPORT STATUS 
SF_CRV_SELF TEST . . 
SF_CRV_WR ACK. . 
SF _CRV_WR_ PROMPTS. 
SFTDEFATTR. . . 
SF_DEF LINKS . 
SF_DELET INTR. . 
SF_DISABLE_HPHIL 
SF_DISABLE KBD . 
SF DISABLE SVC 
SF_DISBL_INTR. . 
SF_ENABLE_HPHIL. 
SF_ENABLE_KBD. 
SF ENABLE SVC. 
ENABL_INTR. 
oF EVENT OFF 
SF_EVENT_ON. 
SF_GET_ATTR. 
SF_GET LINKS 
SF 


INIT. 

INTERVAL. . 
SF_KEYBOARD LED. . 
SF_KEYBOARD_REPEAT 
SF_LOCK - 
SF_MOUSE_COM . 

SF MOUSE OVERRIDE. 
SFTOPEN... |. 
SF_PASS THRU . 
SF REPORT STATE. 
SF_SET_ATTR. 
SF_SET_CRTSW 

SF SET LINKS 

SF SET RAMSW 
SF_START 
SFLTEST. . 
SF_TIMEOUT | 
SF_TRACK OFF 

SF _TRACK_ON. 
SFTUNLOCK. . 
SF_VERSION DESC. 
SF_VID_GET INFO. 
GET_RES 
“VIDTID_ AP 
SF VID~MOD_ INFO. 


nn 
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FLOPPY_SEEK_RECALO. 
FLOPPY SEEK RECALL. 
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Equates File (continued) 


SF_VID_SET_INFO. 
SF VID_SET_MODE . 
TRACK ENABLED. 
T ABSOB. 
T~ABS16. 


T KC ASCII | 
T_KC_ BUTTON. . 
T_KC_HPHIL_ENVOY 


TKC_HP_SOFTKEY. 

T_KC_IBM_AT. 

T_KC_IBM PC. 

T_KC_IS FUNCTION 

TU KC_ITF |. 

T_ KC NUMPAD. 

T_KC_QWERTY. 

T-KC_RO. . 

T KC R11. 

T_KC R3. 

T KO RS. -. 

if KC WILD. 
MOUSE. 

t POINTER. 
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T"UNKNOWN. 
VID BLOCK SIZE 
Vv 8041 . 7 
V~CCP. 
V_-CCPCUR 
V~CCPGID 
V_~CCPNUM 
V-DOLITTLE | 
VIEVENT POINTER. 
VEVENT TABLET 
VUEVENT TOUCH. 
VIFUNCTION . 
VOHPHIL. 
V7 LHPMOUSE 
V7UNULL 
V-LPOINTER 
VILTABLET. 
V-LTOUCH 
V~NUMPAD 


V~PGID_CCP 
V_PNULL. 
V_QWERTY 
V_S$8259. 
V_SCOPY . 
V_SINPUT 
V_ ~SKEY2FKEY. 


V_SOFTKEY. 
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V_SYSTEM 
486z Bytes free 


Warning Severe 
Errors Errors 
0 0 
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APPENDIX F 


F. DEFAULT DEVICE MAPPING 


The following table describes the device mappings which are setup during SYSGEN. The default 
mapping device Is listed first. Other mappable devices are listed following the default device. 


Input System 


Physical Device Logical Device Mappable Driver 


Cursor Control Pad ————> V__PGID__CCP 
V__LHPMOUSE 
VV__LPOINTER 
V__LTOUCH 

V__LTABLET 


V__PGID__CCP 
V__LHPMOUSE 
V__LPOINTER 

V__LTOUCH 
V__LTABLET 


V__LTOUCH 
V__LHPMOUSE 
V__LPOINTER 

V__PGID__CCP 
V__LTABLET 


V__LTABLET 
V__LHPMOUSE 
V__LPOINTER 
V__LTOUCH 
V__PGID__CCP 


Keyboard ——————_> Keyboard Subsystem ————> V__ 8041 


Rotary Knob —————> Cursor Control Pad —————> 


Touch Screen ————> Touch Screen ——_> 


‘0.6. SS 
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Keyboard Subsystem 


Translator Service Mappable Driver 
Function keys ————> V__FUNCTION ——_> non-mappable 


HP softkeys —————_> V__SOFTKEY ————_> SKEY 2FKEY 
V__OFF 
V__RAW 

QWERTY Pad ————> V__QWERTY ——_>> non-mappable 


Numeric Pad ————> V__NUMPAD ————————_> non-mappable 
Cursor Control Pad V__ CCP ———_—_———_——_> V__CCPNUM 
V__LHPMOUSE 


(if installed) 


Discs 


DISC A: Flexible Disc O Upper Drive 
DISC B: Flexible Disc 1 Lower Drive 
DISC C: Internal Hard Disc 

DISC D: External Disc 

DISC E: RAM disc 


Discs on the system are only mappable using ASSIGN.COM. 


Character I/O Devices 


COM1: Serial Port O 
COM2: Serial Port 1 
LPT1: or PRN: Parallel Port O 
LPT2: Parallel Port 1 
LPT3: Parallel Port 2 


These ports are only mappable using MODE.COM. 
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APPENDIX G 


G. DRIVER WRITER'S GUIDE 


This appendix describes how a programmer can add drivers to the ROM BIOS. One of the 
important features of the EX-BIOS is the ease with which it can be expanded. This capability 
allows programmers to take full advantage of HP system components (such as the HP-HIL touch 
screen, mouse, tablet, etc.). In addition, the EX-BIOS architecture provides a simple, yet powerful 
way to integrate OEM and third-party products into the system. 


G.1 Who Should Read This Appendix 


This appendix is intended for all programmers and advanced users who wish to utilize EX-BIOS 
capabilities not supported by system software. It assumes that the reader is familiar with the 
contents of Sections 1 through 10, iAPX286 programming, DOS concepts in general, and DOS 
installable device drivers in particular. The reader should consult the publications listed under the 
References section at the end of this manual for additional information on these topics. 


G.2 Introduction 


This appendix presents two examples of how drivers that interface to the system's EX-BIOS can 
be written. All aspects of how a driver gets connected and used through the EX-BIOS are 
discussed. 
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The typical steps involved in connecting a driver into the EX-BIOS are: 


@ A driver added to the system can be one of three types: ROM driver, MS-DOS installable 
device driver or MS-DOS command that executes and stays resident. 


@ The driver gets called to initialize. At this point the driver will determine what machine It is 
executing on, obtain memory for its data segment, get an EX-BIOS vector address assigned 
and be added to the HP__VECTOR__TABLE. 


@ Any time after initialization the driver can respond to service requests in two ways. It 
responds to a hardware service request when It is called with its F_ISR (AH = 0) function or 
it responds to an application service request when it is called with any other driver specific 
function. 


The above sequence is a general description of a driver's lifecycle. It is not necessary that all 
drivers follow the same steps. The sections below outline what are the necessary elements of an 
EX-BIOS driver. 


Note 


For a detailed explanation of the calls to V_SYSTEM used below see Section 9. 


G.3 Installation of Device Drivers 


Each type of device driver is installed in a different manner depending on how it is brought into 
the system. There are three ways that an EX-BIOS driver can be installed in the system. An I/O 
adapter card can have an EX-BIOS driver which can be installed in the system when the adapter’s 
ROM gets called to initialize. The adapter’s initialization routines can use all of the V__SYSTEM 
functions to properly connect the driver. Note that because the adapter’s code modules are 
initialized during the system generation process (SYSGEN), an EX-BIOS driver on an adapter card 
can not depend on other EX-BIOS drivers already being present and initialized (V__SYSTEM is the 
only driver usable at this point). 


An MS-DOS installable device driver can also install an EX-BIOS driver. The driver must have two 
interfaces, one driver interface for MS-DOS and one driver interface for the EX-BIOS functions. 
This type of EX-BIOS driver can use all other EX-BIOS drivers already present in the system. 


Finally, an MS-DOS command that stays resident can also be used to install an EX-BIOS driver. 


This driver can use all previously installed EX-BIOS drivers. This is the preferred method of 
installing EX-BIOS drivers since it only requires the EX-BIOS driver interface and functions. 
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G.4 Initialization 


This section covers the possible steps the driver must take to insure proper initialization. 


G.4.1 Product Identification 


This section discusses several methods available through ROM BIOS functions for software to 
determine whether its host is an HP Vectra. 


HP Vectra Feature/Revision Identification (V__SCOPY): 
The V__SCOPY (00H) vector entry has a data segment (DS) that points to the system’s copyright 
string. The driver can look at this string to determine if the machine is an HP Vectra. The 


following example illustrates how to get this string: 


MOV BP, V_SCOPY — ; Call the COPYRIGHT vector 


PUSH DS ; which will set the DS and return 
INT = HP__ENTRY 

PUSH DS ; Save DS of copyright string 

POP ES , In ES. ES:0 is address of string 
POP DS ; Recover old DS. 


HP Vectra Indicator Word, Revision Word, and Date Codes 


At ROM address OFOOF8H the HP Vectra has the following data. 


DW ‘HP’ 

DW 0000 

DW Revision__code 

DW Date__code , Byte O = year, byte 1 = week 


This code can be used to discern the HP Vectra from other industry standard products and thus 
take advantage of the unique features of the HP Vectra. This method is not the preferred 
method. 
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STD-BIOS Extension Functions 

The STD-BIOS Functions Fnn__INQUIRE (6FOOH) indicate to the calling application that STD-BIOS 
extension functions are loaded and have not been replaced. The STD-BIOS drivers listed in table 
G.1 below support this function. 

Table G.1 


STD-BIOS Drivers That Support Fnn__INQUIRE 


Interrupt Function 
INT 10 VIDEO 


INT 14 SERIAL 
INT 16 KEYBOARD 
INT 17 PRINTER 


To find out if the STD-BIOS extensions for the Video driver are in place use the following code: 


MOV AX, F10__INQUIRE ; Call video function (6FOO) 
MOV BX, OFFFFH ; Make sure BX <> ‘HP’ 

INT INT__VIDEO ; Interrupt 10H 

CMP BX, ‘HP’ , Are video extensions present? 


JE VIDEO__EXTENSIONS__ PRESENT 
VIDEO__EXTENSIONS__NOT__PRESENT: 


VIDEO__EXTENSIONS__PRESENT: 


G.4.2. Obtaining Memory From the EX-BIOS 


The system allows EX-BIOS drivers to obtain limited amounts of memory independent of the 
operating system. This feature is especially important for I/O ROM adapters since their cost can 
be reduced if they do not require dedicated RAM. When the I/O ROM module is initialized, it can 
ask for EX-BIOS memory. 
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This feature of the EX-BIOS system can also be utilized by application programs and system 
software. Any program needing a limited amount of RAM outside the operating system domain 
can obtain this from the EX-BIOS system. 


The functions F_RAM__GET and F__RAM__RET in the V__SYSTEM driver can be used to 
manipulate the EX-BIOS free memory. The driver can also use the installation functions 
F__INS__FREEGETDS or F__INS__FIXGETDS to obtain free memory. See Section 9 for more details 
of these functions. 


G.4.3 Getting a Free Vector 


In order for an application to access an EX-BIOS driver it must call the driver through the 
HP__VECTOR__TABLE. Thus, each driver must request a free vector from this table. 


To get a free vector from the HP__VECTOR__TABLE, a driver can use the function 
FINS. XCHGFREE, F__INS__FREEOWNDS, F__INS__FREEGETDS or F__INS__FREEGLBDS in the 
\VV__SYSTEM driver. Each of these functions installs the driver at the next available free vector. 


Once the driver has a vector address installed in the table, an application can call the driver by 
loading BP with the vector address of the driver and doing an HP__ENTRY interrupt (6FH). 


G.5 EX-BIOS Driver Functions 


EX-BIOS drivers support a standard set of functions and subfunctions. Nine standard function 
codes are defined, and several of these functions have subfunctions defined within them. These 
functions and subfunctions are summarized in table G.2. A detailed description of each defined 
function and subfunction follows. 


If a driver receives a function it does not implement, it must return a status code of 
RS__UNSUPPORTED (02H) in the AH register. This lets the application know that the driver has 
not handled this function, but that it can continue if it is appropriate. This protocol frees the 
driver from having to implement all the defined functions and allows applications to call drivers 
in a consistent way. 


If a driver receives a function code that it does not implement, it may also “‘delegate”™’ the 


function to another driver. A driver may be written so that it calls another driver when it receives 
an unimplemented function or subfunction request. 
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Programmers may write drivers that implement functions and subfunctions that are not defined. 
However, two guidelines should be observed when defining additional functions or subfunctions. 
First, whenever possible, newly defined function or subfunction numbers should not conflict with 
existing numbers. Secondly, function and subfunction numbers should be consistent between 
drivers of the same class. 


Table G.2 


EX-BIOS Driver Function Code Summary 


Function Register 
Subfunction AH AL Definition 
F__ISR 00 Responds to a logical Interrupt Service 
Request (ISR). 
F_ SYSTEM Executes one of several standard 
subfunctions. 


SF__INIT* O02 OO Starts the initialization of a driver. 
SF__START* O02 OQ2 Completes the initialization process of the 
driver. 


SF__REPORT__STATE O2 O04 _~ Reports the state of the driver. 
SF__VERSION__DESC* Q2 06 _— Reports the revision number and datecode 
of the driver. 


SF__DEF__ATTR O2 O08 _ Reports the default configuration of the 
driver. 

SF__GET__ATTR O2 OA Reports the current configuration of the 
driver. 

SF__SET__ATTR O2 QC Overrides the current configuration of the 
driver. | 

SF__OPEN O2 OE _ Reserves the driver for exclusive access. 
Requests any resources required by the 
driver. 

SF__CLOSE Q2 10 Releases the driver from exclusive access. 

SF__TIMEOUT O02 12 _ Reports to the driver that a requested 
timeout has occurred. 

SF__INTERVAL O02 14 ~ Reports to the driver that a requested 60 Hz 
interval has expired. 

SF__TEST O2 16 Performs a hardware test. 
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Function Register 
Subfunction AH AL Definition 


F_ IO__CONTROL Executes the following subfunctions and any 
driver dependant subfunctions. 
SF__LOCK QO4 QO _ Reserves the sub-address device specified for 
exclusive access. 
SF__UNLOCK Q2 Releases the sub-address specified from the 
exclusive access. 


F__PUT__BYTE Writes a byte of data. 
F__GET__BYTE Reads a byte of data. 
F__PUT__BUFFER Writes a variable length buffer of data 
(Supported by character devices). 
F__PUT__BLOCK Writes a fixed length buffer of data 
(supported by block devices). 
F__GET__BUFFER Reads a variable length buffer of data 
(Supported by character devices). 
F__GET__BLOCK Reads a fixed length block of data 
(supported by block devices). 
F__PUT__WORD Writes a word of data. 
F__GET__WORD Reads a word of data. 


Note: Functions marked with an asterisk (*) should be supported by all drivers. These functions 
may perform no useful function. However, they should return a status code of RS__DONE or 
RS__ SUCCESSFUL as opposed to RS__UNSUPPORTED. 


The following is a list of predefined driver function codes and a brief description of their purpose 
and parameters: 


EX-BIOS Driver Function Definitions 


F_ISR (AH = OOH) 


This function processes either a logical or a physical interrupt event. It reports whether or not It 
handled the event through its Return Status Code (see table G.2). The driver may require the 
service of its parent driver to handle the interrupt. 
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EX-BIOS drivers do not usually enable interrupts (STI) while processing this function code. Drivers 
should service this interrupt within 250 microseconds or maintain interrupts off for no more than 
250 microseconds at a time. Drivers should expect 40 bytes of stack when called. If a driver 
enables interrupts it must provide 40 bytes of stack for other ISR’s. 


On Entry: AH = F_ISR 


On Exit: AH = RS_ SUCCESSFUL 
or RS__NOT__SERVICED 


F_SYSTEM (AH = 02H) 

This function contains a set of subfunctions that execute system-oriented tasks. These 
subfunctions include driver setup, configuration, and control. The F_SYSTEM subfunctions are 
described in detail below. 

SF_INIT (AX = 0200H) 

This starts the initialization process of a driver. The function does not return to the caller unti! the 
driver is ready to be called by another driver. All system services (V__SYSTEM) are assumed to be 


operational when a driver is called by this function. 


The driver is responsible for a brief hardware check and to report RS__FAIL if the test failed. A 
driver need only execute a test procedure if it directly interfaces to physical hardware. 


If the driver requires EX-BIOS RAM the BX and DX registers can be used to reserve available 
memory (see Section 9). 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_INIT (OOH) 
BX = ‘‘last used DS” 
BP = Driver's vector address 
On Exit: AH = Return Status Code 
BX = New ‘last used DS” 


Recommended for hardware test failure: 


AH = RS__FAIL 
ES:DI = pointer to a string of information about the nature of the error 
CX = length of the string pointed to by ES:D! 
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SF_ START (AX = 0202H) 


This function notifies a driver that tt may call other drivers for any additional setup it may require. 
All other ROM drivers and ROM services are present, active and capable of being accessed. This 
function does not usually return to the caller until all its internal and external setup is complete. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__START (02H) 
BP = Driver's vector address 


On Exit: AH = Return Status Code 


SF__REPORT_STATE (AX = 0204H) 


Reports a word of status or state information to the caller in the DX register. The format of the 
state information will be presented bit wise and should be presented in the same format for all 
drivers of the same class. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__REPORT__STATE 
BP = Driver's vector address 
On Exit: AH = Return Status Code 
BX = State of Driver 


SF_VERSION__DESC (AX = 0206H) 


Reports the version number of the driver code and an optional describe record which contains 
other driver-dependent information. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__VERSION__DESC (06H) 
BP = Driver's vector address 
On Exit: AH = Return Status Code 
BX = Version number, YYWW is a BCD number where, 
WW is the week of the year 
YY is the number of years since 1960 
CX = Number of bytes in data buffer 
ES:DI = Pointer to describe record 


Driver Writer's Guide 433 


SF_DEF_ATTR (AX = 0208H) 


Returns a pointer in ES:DI to a parameter block containing the driver's default configuration 
values. This function does not set the defaults; it only reports them. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__DEF__ATTR (08H) 
BP = Driver's vector address 
On Exit: AH = Return Status Code 
CX = Number of bytes in data buffer 
ES:DI = Pointer to a data buffer 


SF_GET_ATTR (AX = 020AH) 


Reports the configuration values defined by the parameter block. Baud rates, HPIB addresses, 
etc. may be reported by this command. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__GET__ATTR (OAH) 
BP = Driver's vector address 
On Exit: AH = Return Status Code 
CX = Number of bytes in data buffer 
ES:DI = Pointer to a data buffer 


SF_SET_ATTR (AX = 020CH) 


Sets the parameter block defined by ES:DI as the configuration values. Baud rates, HPIB 
addresses, etc. may be defined by this command. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__SET__ATTR (OCH) 
BP = Driver's vector address 
CX = Number of bytes in data buffer 
ES:D| = Pointer to a data buffer 
On Exit: AH = Return Status Code 
ES:D| = Pointer to a data buffer 
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SF_OPEN (AX = 020EH) 


Allows exclusive access to this driver. All resources required for driver operation will be acquired 
at this time. This function has special meaning for the the HP-HIL driver, the HPIB driver and the 
HPIL driver. Since these drivers support shared interfaces, control of the resource HP-HIL 
(obtained from the driver V__HPHIL), control of the HPIB (in contention with other PC’s on the 
bus), and control of the HPIL (in contention with other PC’s on the loop) is requested and 
obtained. Control should be kept until a single operation is performed on the resource. A status 
of RS__BUSY will be reported if the device has previously been opened. RS__SUCCESSFUL will be 
reported if the device Is available. A busy status does not prevent access to the driver. All 
functions will execute (perhaps improperly) whether a driver has been opened or not. 


On Entry. AH = F__SYSTEM (02H) 

AL = SF__OPEN (OEH) 

BP = Driver's vector address 
On Exit: AH = Return Status Code 


SF_CLOSE (AX = 0210H) 


Closes the requested resource. Again this function has special meaning for the interface class of 
devices, HPIB, HP-HIL, and HPIL. The driver goes to a state where control can be obtained by or 
passed to another controller. 


On Entry: AH = F__SYSTEM (02H) 

AL = SF__CLOSE (10H) 

BP = Driver's vector address 
On Exit: AH = Return Status Code 


SF_TIMEOUT (AX = 0212H) 


Reports to the driver that its timer event number has occurred. 


On Entry: AH = F__SYSTEM (02H) 
AL = SF__TIMEOUT (12H) 
BP = Driver's vector address 
On Exit: AH = Return Status Code 
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SF_INTERVAL (AX = 0214H) 


Reports to the driver that its interval event number has occurred. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF__INTERVAL (14H) 
BP = Driver's vector address 
On Exit: AH = Return Status Code 


SF_TEST (AX = 0216H) 


The driver performs a hardware test and reports RS__FAIL if the test failed. A driver need only 
execute a test procedure if it directly interfaces to physical hardware. 


On Entry: AH = F_SYSTEM (02H) 

AL = SF__TEST (16H) 

BP = Driver's vector address 
On Exit: AH = Return Status Code 


On test failure: 
CX = The length of the string pointed to by ES:DI 
ES:DI_ = Pointer to a string of information about the nature of the error 

F_1IO_ CONTROL (AH = 04H) 
This is a collection of driver dependant control subfunctions. Drivers of the same class should 
implement similar subfunctions. The following is a list of predefined driver subfunction codes and 
a brief description of their purpose and parameters: 
SF_LOCK (AX = 0400H) 


Reserves the indicated addresses on an already allocated driver for exclusive access. 


On Entry: AH = F_IO__CONTROL (04H) 
AL = SF__LOCK (00H) 
DH,DL = Major and minor address (Optional) 
BP = Driver's vector address 


On Exit: AH = Return Status Code 
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SF_UNLOCK (AX = 0402H) 


Releases the indicated address from exclusive access. 


On Entry: AH = F_IO__CONTROL (04h) 
AL = SF_UNLOCK (02H) 
DH,DL = Major and minor address (optional) 
BP = Driver's vector address 


On Exit: AH = Return Status Code 


F_PUT__BYTE (AH = 06H) 


This is a generic put data byte function. 


On Entry: AH = F__PUT__BYTE (06h) 
AL = Data byte 
BP = Driver's vector address 
On Exit: AH = Return Status Code 


F_GET_BYTE (AH = 08H) 


This is a generic get data byte function. 


On Entry: AH = F__GET__BYTE (08H) 
BP = Driver's vector address 

On Exit: AH = Return Status Code 
AL = Data byte 


F__PUT__BUFFER OR F_PUT_BLOCK (AH = OAH) 


Puts a number of bytes to a device. The difference between a buffer device and a block device is 
that a buffer device accepts variable length records, while a block device accepts fixed length 
records. Thus, a printer is a data buffer device and a disc is a block device. Usually, a block device 
requires more parameters than a data buffer device, consequently there is a different format for 
parameter passing. 
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F_PUT_BUFFER (AH = OAH) 


This is a generic put data buffer or put data block function. Either a string write or a disc block 
write could use this function. 


On Entry: AH = F__PUT__BUFFER (OAH) 
CX = Data byte count or block count 
ES:DI = Pointer to data buffer 
BP = Driver's vector address 
On Exit: AH = Return Status Code 


F_PUT_BLOCK (AH = OAH) 


Writes a fixed block of data to a block device. 


On Entry: AH = F_PUT__BLOCK (OAH) 
DH = Major number 
DL = Minor number 
ES:DI_ = Command Block 


Word 0,1: Data transfer address 

Word 2: Block count 

Word 3: Block address LSW 

Word 4: Block address MSW (for some devices this word Is ignored). 


BP = Driver's vector address 


On Exit: AH 
BX 


Return Status Code 
Operation status 


F__GET__BUFFER OR F__GET_BLOCK (AH = OCH) 


F_GET__BUFFER (AH = OCH) 


This is a generic get buffer or get block function. Either string reads or disc block reads could use 
this function. | 


On Entry: AH = F__GET__BUFFER (OCH) 
CX = Byte count or block count 
DS:S| = Pointer to data buffer 
BP = Driver's vector address 
On Exit: AH = Return Status Code 
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F_GET_BLOCK (AH = OCH) 


Reads a fixed length block of data from a device. 


On Entry: AH 


UO 
rr 
Hoi ul il 


F__GET__BLOCK (OCH) 
Major number 

Minor number 
Command Block 


Word 0,1: Data transfer address 

Word 2: Block count 

Word 3: Block address LSW 

Word 4: Block address MSW (for some devices this word is ignored). 


Br. = 


On Exit: AH 
BX 


F__PUT__WORD 


Driver's vector address 


Return Status Code 
Operation status 


(AH = OEH) 


This is a generic put word of data function. If the destination device is byte wide then the byte in 
the DL register is written first followed by the byte in the DH register. 


On Entry: AH = 
DX = 
BP = 
On Exit: AH = 


F__GET_WORD 


F__PUT__WORD (OEk) 
Data word 
Driver's vector address 


Return Status Code 


(AH = 10H) 


This is a generic get word of data function. If the source device is byte wide then the first byte is 
read into the DL register and the second byte is read into the DH register. 


On Entry: AH = 
BP = 
On Exit: AH = 
DX = 


F__GET__WORD (10h) 
Driver's vector address 


Return Status Code 
Data word 
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G.6 Return Status Codes 


The conventions for assigning return status codes are as follows: 
@ |f possible, use a return status that has already been defined. 
@® Error conditions should be reported with a negative byte (OFEH—O8OH ). 


@ Status or exceptional conditions “‘soft errors’’ should be reported with a positive byte (02— 
7EH). 


@ Good Status is always reported as OOH. 


Table G.3 summarizes the already assigned status codes. 
Table G.3 
EX-BIOS Return Status Codes 


Return Status Indication 


RS__ SUCCESSFUL The requested function executed 
correctly. 

RS__ UNSUPPORTED The requested function or subfunction Is 
not implemented or is unsupported. 

RS__NOT__SERVICED The requested function was not executed 
by this driver. Any drivers which are 
chained on this interrupt vector should 
be called in turn until a return status of 
RS__SUCCESSFUL or some other error Is 
reported. 
This return status is used by the Input 
System translators to indicate that an ISR 
event has been handled and no further 
processing should be done. 


RS__FAIL (-Q2H) The driver failed the operation in an error 
State. 

RS__ TIMEOUT (-O4H) The device timed-out on a physical event 
in an error state. 

RS__BAD__PARAMETER (-OQ6H) The driver received a bad parameter. 

RS__ BUSY (-Q8H) The requested driver is busy. 

RS__NO__ VECTOR (-OAH) HP__VECTOR__TABLE Is out of RAM or 
room for more drivers. 

RS__OFFLINE (-OCH) Device is offline. 

RS__OUT__OF__PAPER (-OEH) Device Is out of paper. 
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G.7 Driver Headers 


The EX-BIOS driver header (HP__SHEADER) is a formatted data structure similar to the DOS 
device driver's header. It defines the attributes of a driver, defines the linkage of a driver and 


identifies the driver. It also allows the programmer to define how the driver links with other 
drivers. 


All EX-BIOS drivers must have an HP__SHEADER. Programmers are not required to provide a 
complete HP__SHEADER to use the HP_VECTOR__TABLE. But, if they choose to take advantage 
of the advanced features of the EX-BIOS the programmer must implement a complete 
HP__SHEADER. Table G.5 shows a complete driver header and what fields must be present. 


Table G.4 


Driver Header Table 


Variable Offset Type Definition 


DH__ATR* 0 Word _ Driver Attribute Field 
DH_HNAME__INDEX 2 Word _ Driver String Index Field 
DH__V__DEFAULT 4 Word _ Driver's Default Logical Device Vector 
DH__P__CLASS** 6 Word Driver's Parent Class 


DH__C__CLASS** 8 Word _ Driver's Child Class 
DH__V__ PARENT ** OAH Word Driver's Parent Vector 
DH__V__CHILD** OCH Word Driver's Child Vector 
DH__MAJOR** OEH Byte  Subaddress Field 
DH__MINOR** OFH Byte | Subaddress Field 


*This is the only field required for a driver to be in the HP_.VECTOR__TABLE. 


**These fields are only required by drivers that want to do device mapping. 
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G.7.1 HP__SHEADER Fields 


DH__ATR: 


Each bit in the DH__ATR field indicates a property of the driver for device 


mapping purposes. These bits are defined in table G.5. 


Table G.5 
Device Attributes Bits 


Bit 


15 


14 
13 


12 


ATR Name 
ATR__HP 


ATR__DEVCFG 
ATR_ISR 


ATR__ENTRY 


11:9. ATR__TYPE__MASK 


ATR__RSVD 
ATR__FREE 


ATR__SRVC 
ATR__LOG 
ATR__IND 


ATR__BOT 


ATR__INP 


ATR__STRING 
ATR__MAP__CALL 
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Data Description 


000 
001 


010 
011 


The following bytes form a complete driver 
header. 

The bytes that follow are not a driver header. 
Reserved. 

The driver can be mapped with 
DH__V__PARENT. 

The driver can be mapped with DH__V__CHILD. 


These three bits indicate the driver type. 

This is a reserved vector. 

This is a free vector. The V__SYSTEM service 
allocates free vectors to new drivers upon 
request. 

This driver is an EX-BIOS service. 

This is a logical driver. Its mapping direction Is 
from parent to child. 

This is a mappable driver that cannot be the last 
in the chain of drivers. 

This is a mappable driver that is the last in a 
chain of drivers. This driver can only be a child 
driver. This driver maps with ATR__LOG, 
ATR__IND and ATR_BOT drivers. 

This driver is an input driver and is mappable. 
Reserved 


Reserved 
This driver's SF__START subfunction should be 
called whenever the driver is remapped. 


Bit 


NO Ww £& 


oO 


ATR Name 


ATR__SUBADD | 


ATR__NOADDR 
ATR__MAJOR 


ATR__MINOR 


ATR__MID 


ATR__PSHARE 
ATR__CSHARE 
ATR__ROM 


ATR__YIELD 
Reserved 


DH__NAME__INDEX: 


DH__V__ DEFAULT: 


| Data 


Description 


These bits specify what type of major and minor 
addresses the driver requires. 

The driver does not require any address. 

This driver requires that a major address be 
specified and stored in the parent driver's 
DH__MAJOR header record. The range of 
possible major addresses is 0 through the 
contents of this header’s DH__MAJOR. 

This driver requires that a minor address be 
specified and stored in the parent driver's 
DH__MINOR header record. The range of 
possible MINOR addresses is 0 through the 
contents of this header’s DH__MINOR. A driver 
cannot require a minor address unless It also 
requires a major address. 

This driver requires a major address, a minor 
address, and a mid address. The minor address 
field is split into an upper and a lower nibble, 
with che upper nibble indicating the mid address 
and the lower nibble indicating the minor 
address. The range of addresses possible is 
specified by the child physical driver. 


a 


This driver cannot be shared between several 
parent drivers. 

This driver cannot be shared between several 
child drivers. 

This driver header is in ROM and cannot be 
altered unless copied to RAM. 1 Reserved 
Reserved. 


The DH__NAME__INDEX is used to derive the 
localization string index of the driver. This is given 
by the function F__STR__GET__STRING in the 
V__SYSTEM driver. See Section 9 for additional 
information. 


The DH__V__DEFAULT field contains the driver's 
default vector address. 
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DH__P__ CLASS and DH__C__CLASS: In conjunction, these fields indicate which drivers 
may be mapped together. DH__P__CLASS and 
DH__C__CLASS are bit masks. Each bit position 
represents a set of drivers. If a bit is set then the 
driver is in that set of drivers. The DH__P__CLASS 
field indicates a driver is in from 0 to 16 different 
driver sets. A driver can only map to another driver 
if tts DH__P__CLASS field matches at least one bit 
position of another driver's DH__C__CLASS field. 
Furthermore, DH__ATR field is another condition of 
mapping. The bits are defined in table G.6. 


Table G.6 


Class Bit Positions 


Class Definition 
Hex Bit Name (If bit = ‘1’, driver is member of class) 


CL__KBDFC This set of drivers maps to the f1 through f8 softkeys 
of the keyboard. 

CL__KBD — (this is not the device accessed through INT 
16). 

CL__CCP Cursor pad device (for example, V__CCPCUR, V__CCP 
NUM, V__OFF, V__RAW, V__CCP, V__FUNCTION). 

CL__CON This set of devices map to the console device. 


CL__ BYTE Serial output device, which may be capable of limited 
input. 

CL__COMM Reserved 

CL_INTERFACE An interface class controlling multiple resources 
transparent to the operating system. It provides 
major, middle, and minor address modes for the 
calling application or driver. Examples are the HP-HIL 
driver, the HPIB driver, and the HPIL driver. 

CL__FILT Serial output device filter. This driver can be mapped 
in between a logical driver and a physical driver and it 
can translate from one character set to another. 


444 Driver Writer’s Guide 


Hex 


0080 
0040 


0020 


Bit 
07H 
O6H 


O5H 


Class 


Name (If bit = ‘1’, driver is member of class) 

ClL__BLK Addressed block device. 

CL__BOOT Logical device used as the priority boot device. If set 
on a physical device, the device is capable of being a 
boot device. Typically a physical driver would have 
both the CL__BOOT bit set and the CL__BLK bit set. 

CL__LGID Logical graphics input device (for example 
V__LTABLET, V__LPOINTER V__LHPMOUSE, physical 
GID devices and the keyboard driver). This class maps 
to logical devices which are not the child of another 
driver. 

CL__PG!D This class of driver can map to a device which is the 
child of another driver. 

CL__GID This class is reserved for all drivers which can map to 
an event. 

CL__PTS Physical touch device (for example, physical GID 
drivers or V__LTOUCH). 

Choi Reserved 

CL__00 Class Extension Bit 
Special Group Classes 

CL__ALL This device maps to all other devices (V__PNULL). 


CL NULL 


DH__V__PARENT: 


DH__V__CHILD: 


DH__MAJOR: 


DH__MINOR: 


Definition 


This device maps to no other driver. 


The DH__V__PARENT field contains a vector to the driver that is called 
when the current driver receives an F__ISR function code that it 
cannot or doesn't know how to process. 


The DH__V__CHILD field contains a vector to the driver that is called if 
this driver decides it cannot handle the request function (as long as 
that function is not F__ISR). 


Major address range. 


Minor address range. 


See the HP__SHEADER macro definition in the equate files listed in Appendix E. 
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G.7.2 Driver Mapping 


Two drivers may be mapped together if the drivers have matching paren: and child class records. 
The mapping rule for the drivers is defined in table G.7. 


Table G.7 
PARENT/CHILD Mapping Rules 


Parent Child 

El! e_El Connection Rule 

O O O O — Drivers are not to be connected 

0001 —" 

0 (0° 1.00 =? 

0011 —" 

0100 —"”" 

O 1 0 1 — Child’s DH_V__PARENT < parent's vector address 

O 1 1 O — Drivers can not be connected 

O 1 1 1 + — Child's DH_V__PARENT < parent's vector address 

1 0 0O O — Driver's are not connected 

YOO fa ae 

1 0 1 =O — Parent’s DH__V__CHILD < child’s vector address 

1 0 1 #1 = — Parent's DH__V__CHILD < child's vector address 

1 1 0 O  --— Driver's are not connected 

1 1 0 1° -— Child's DH_V__PARENT < parent's vector address 

1 #1 #1 +O — Parent's DH__V__CHILD < child’s vector address 

1 1 1 =1 = =— Child's DH_V__PARENT < parent’s vector address and 
Parent's DH__V__CHILD << child's vector address 

Where, 


E = ATR_ENTRY bit state 
| ATR_ISR bit state 


G.8 Accessing Driver from an Application 


When an application needs to access a driver the following sequence must take place: 
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MOV BP. driver’s vector address 7 1.e. V__SYSTEM (12H) 
MOV AH, function code 
MOV AL, subfunction code 


, any other data passed 


, in registers 
PUSH  =—DS ; Saves application's DS 
INT HP__ENTRY ; (6FH) 


POP DS 


G.9 Examples of EX-BIOS Drivers 


G.9.1 Cursor Pad Scan Code To HP Mouse Driver 


The first example driver is called CPP2GID. This driver implements the V__CCPGID EX-BIOS driver. 
As such, it translates from cursor control pad keys into graphics input device data. 


The driver is installed into the HP__VECTOR__TABLE. The SF__INIT subroutine of the driver asks 
for enough EX-BIOS RAM to store the driver header and describe record. The DH__V__PARENT 
field of the V__CCPGID driver header is initialized to V_.LHPMOUSE. The DOS driver portion calls 
SF__START of the EX-BIOS driver. SF__START initializes the DH__V__PARENT field of the V__CCP 
driver header to V__CCPGID. Then V__LHPMOUSE driver is called with the override function. 


The installable driver completes initialization by printing an initialization completed message and 
returning back to DOS. 


Now when the keyboard driver calls V__CCP to process a cursor control pad key, V__CCP calls 
V__CCPGID. The F__ISR of V__CCPGID decodes which key was actually hit. The driver converts 
the cursor movement keys (up, down, left, and right) into relative movement data. If the key 
pressed was an insert or delete key, It is reported as the left or right button respectively. First the 
driver changes the describe record and then reports either a button press or a button release. 
After the input data is given to V__LHPMOUSE, the data is available thru the INT 33H STD-BIOS 
driver. 
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CCP_TO__GID__ FILTER 


WWW) WW) WW GAD AD PRD AD AD 200 AD PO PO AD bb Bb bb © 00 I OU & WIA) 
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page 59,132 


title CCP _TO GID FILTER installable driver 


-weeDRIVER HEADEReesecmee see a ecm eRe RRS TEER ER ER ER ERROR RSE REE 


NAME: CCP_TO GID FILTER Installed DRIVER 


; DESCRIPTION: This is an EX-BIOS driver which converts cursor 
: control p2e cursor keys into GID, T_REL16, movements 
i It is a brother to the V_CCPCUR, V_CCPNUM, V_RAW, and 
: V_OFF, filters of the V_CCP translator. 
? One cursor ae | report generates one micky in the direction 
; indicated by the cursor pad key. In addition the cursor 
; control pad <Ins> key is mapped to the Bl <o> mouse button 
and the cursor control pad <DEL> key is mapped to the B2 <oo> 
: mouse button. 
. OPERATION: 
: This driver is installed through the MS-DOS installed device 
: driver system with the command line: 
: devicesCCP2GID EXE 
; The driver links itself into the HP_VECTOR TABLE and maps 
itself to be the parent driver of the V_CCP driver. 
: The driver then returns to DOS releasing the initialization 
; code it no longer requires back to DOS. 
; PARAMETERS 
: ON ENTRY: in MS-DOS portion: es:bx points to 
: ay aioe Request Header 
: in HP portion ah contains function 
: code, al usually contains 
; the output character 
ON EXIT: in MS-DOS portion. status is returned in 
By Sel Request Header 
in HP portion: ah contains the return 
status code 
REGISTERS ALTERED: in MS-DOS portion: none 
in HP portion ax, bx, di, bp 
chen es Cen eeeCseeuveneneeeunenhaeheesceeecevedsawecnerewcussseceuueeusae 
HP_SHEAOER struc 
DH ATR dw 0 
DH NAME INDEX dw 0 
DH_V_DEFAULT dw 0 
DH P_CLASS dw 0 
DH_C CLASS dw 0 
DH _V_ PARENT dw 0 
DH_V_CHILD dw 0 
DH MAJOR db 0 
DH MINOR db 0 
HP _SHEADER ends 
HP_ENTRY equ O6FH 
SYSCALL macro vector 
iffnb <vector> 
mov bp .vector 
endif 
int HP ENTRY 
endm 
ATR _ CSHARE equ 0008H 
ATR DEVCFG equ 4000H 
ATR_HP equ 8000H 
ATR_ISR equ 2000H 
ATR_LOG equ 0600H 
Ci _Cce equ 2000H 
CL_LGID equ 0020H 
DESCRIBE STRUC 
db size HP _SHEADER dup (7) : this data is always offset by 
D_SOURCE db ? 7-4 (high nibble) contains the GIO type 
3-0 {low nibble) is the address of the device 
D_HPHIL_ID db ? device id byte returned by an HPHIL device 
D DESC MASK db ? describe header from HPHIL device 
0 10 MASK db ? 1/0 descriptor byte from device 
D XDESC MASK db ? extended describe byte from device 
D MAX AXIS db ? maximum number of axis reported 
D CLASS db ? device class 
7-4 (high nibble) contains current class 
. 3-0 (low nibble) contain the default class 
D_ PROMPTS db ? , number of buttons/prompts 


7-4 (high nibble) is the number of prompts 
3-0 (low nibble) is the number of buttons 


CCP__TO__GID__FILTER 


Q5 0018 77? D_RESERVED db ? ; reserved for future 
96 0019 ?7 D BURST _LEN db ? ; maximum burst as Ba output to a device 
97 7 ~ - if devices supports more than 255 bytes then 
08 255 bytes is the default maximum 
99 OO1A 7? D_WR_ REG db ? number of write registers supported by a device 
100 0018 ?7 D_RD_REG db ? number of read registers supper yes by a device 
101 001C ?? D_ TRANSITION db ? transitions reported per button 
102 001iD ?? O ST db ? - current state of buttons 
103 OOlE 777? D RESOLUTION dw ? ; counts / cm (m) returned by HPHIL device 
104 0020 777? DO SIZE_X dw ? - Maximum count of in units of resolution 
105 0022 7777? OD SIZE_Y dw ? ; 
106 0024 ?777 D_ABS X dw ? : data reported from device 
107 0026 7777? D ABS _Y dw ? - that reports absolute data 
108 0028 7777 D REL _X dw ? - data reported from device 
109 002A 7777 D RELY dw ? that is relitive 
110 002C 7777? D_ ACCUM X dw ? these are used to accumulate scaling 
111 OO2E 777? D_ACCUM_Y dw ? remainder 
ce 0030 DESCRIBE ENDS 
recs » 0030 DESCRIBE SIZE equ size DESCRIBE 
116 » OO1E D_CCP_STATE equ D_STATE + 1 
117 = D_SIZE equ D SIZE X 
118 . D_ SAMPLE ABSOLUTE equ D_ABS X 
119 . D_SAMPLE RELATIVE equ D_REL X 
120 . D_REMAINDER_ ACCUM equ D_ ACCUM X 
121 = D_BUFFER equ DO SIZE X : offset where buffer begins 
122 =» 00FO DO CLASS CURRENT equ OFOH 
123 =» 0OOF O_CLASS DEFAULT equ OOFH 
124 - The field LO SOURCE uses the ro yeew eng to access the defined nibbles 
125 e OOOF D_ADDR_ MASK equ OOFH 
126 =» 00FO D_TYPE MASK equ OF OH 
1 
128 =» OOOE F_INS FIXGETDOS equ OOOEH 
129 » 0004 F_ 10 TONTROL equ 0004H 
130 = 0002 SF MOUSE OVERRIDE equ 0002H 
131 » 0000 F_TSR equ 0000H 
132 » 0002 F SYSTEM equ 0002H 
cr * 0002 SF_ START equ 0002H 
135 , RXKEKAKAAAKKKKAKKAAAKAKAKAKKAKAKKKAAKAKAAKAKAAKAKKKAKKAAKAKAKAKAKKAAKAKKAAKAKKAKAKAKAKAAKAKAKKAKAKALAAAKKAS 
136 ; the following structures are used to access MS-DOS driver command blocks 
137 ese sees T TCT EST S TESS TSS OST OSS OST ECS CS SCS SS SCS ESSEC OSS OSES SST CCS ESS SET OT Tete 8 
138 MSD_HEADER macro ATT STRATEGY ENTRY ,ISR_ENTRY,STRING 
139 dd -1 ‘mark a® last driver in list 
140 dw ATT 
141 dw STRATEGY ENTRY 
142 dw ISR_ENTRY 
143 db STRING 
144 db 14 dup (7) ; Pad so it is paragraph aligned. 
145 endm 
146 
147 MSD REQ HEADER struc ,00: structure for access to MS driver cmds 
148 0000 ?? MSD _CMOLEN db ? ,00; eens of cmd in bytes including data @ end 
149 0001 7? MSD_UNIT db ? ,O1; unit number for command 
150 0002 ?? MSO_ CMD db ? :02; command code 
151 0003 777? MSD _ STATUS dw ? (03, filler with completion status before return 
182 0005 08 [ db 8 dup (7) : . area reserved for DOS 
153 7? 
154 ) 
i 
157 0000 ?7 MSD MEDIA db ? .13; most cmds have this defined in the data area 
158 OOOE 7777 MSD_ TRANS dw ? (14; 
159 0010 777? dw ? ; 16; 
160 0012 7777 MSD_ COUNT dw ? ,18, 
161 0014 7777 MSD START dw ? ,20, 
tee 00186 MSD_REQ_HEADER ends 
1 
164 MSD_INIT_CMD struc 
165 0000 0D [ db 13 duo (7) ‘first cover header area 
1686 ?? 
167 ) 
186 00D 2 

000 ? MSD _ UNIT COUNT db ? 0B :number of units service by this driver 
170 OOOE 7777 MSD _ENO_OFFSET dw ? OC :,offset of ond of code a 
171 0010 777? MSD_END_ SEG dw ? OE :segment address of end of code 
We $b 38 messages’ Ge 

727 MSD BP G dw ? 14 ;seg:offset of BPB list for units attached 

174 0016 ?? MSD_1ST_UNIT db 2 16 fis driver letter of fir i 
175 0017 MSD_INIT_CMD ends se 
177 = 0000 MSD_INIT equ 0000H 
178 » 0003 MSD UNKNOWN CMD equ 0003H 
He 7 S08 reo tases sy $8908 

. jis U equ 100000018 ;used as upper byte in status wrd 
ee » 0001 MSD DONE STATUS equ 000000018 . bit Yeeerr bit 8=done 
183 » 0006 RS DONE equ 0006H 
184 » 0000 RS SUCCESSFUL equ 0000H 
2 =» 0002 RS UNSUPPORTED equ 0002H 
187 = 0009 T_KC_ BUTTON equ 0008H 
188 » 0041 T RELI6 equ 0041H 
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189 
190 = 0006 V_DOLITTLE equ 0006H 
191 © 00A2 V_CCPGID equ O0A2H 
» 00CC V_LHPMOUSE equ 00CCH 
» 0012 V_SYSTEM equ 0012H 
= QOO4E V_CCP equ OO04EH 
« 0080 UP_DOWN BIT equ 100000008 :;Key up or down 
= OOFF INIT BUT STATE equ OFFH -All off 
=» 004C MSE _NUM_BUTTON equ 004CH Offset of number of button in mouse RAM 
# 0030 CCP2GID_ DESC SIZE equ 48 
= £608 CCP2GID_HP_ATTR equ ATR_HP+ATR_DEVCFG+ATR_ISR+ATR_LOG+ATR_ CSHARE 
: MS-DOS device drivers start at an offset of 0 rather than 100h. ; 
CGROUP group CODE 
0000 CODE segment public ‘CODE’ 


assume cs CODE. ds NOTHING 
or 
0000 CCP2GID_INSTALLED LABEL FAR 


“SES BERBSSRSSSRSSRSSHSSSSSHESSESSFSTSSPSSSVSSBZPSSSSSSSPCBSSVSSSRBPBBSBBBREABBeeaeeaenasezs: 
This is the start of MS-DOS driver portion of the code. It pretends 
to be a standard MS-DOS driver long enough to be loaded and ; 
initialized via CONFIG SYS. After that this section of code will : 

; not be used. (section 1) ; 

, SS SSSSSSSSSS SSA SSSSSSSSSSSSSSHU HT SSS SASH RR AREA T TRESS ERTS ESET ASR Re 

; This is the MS-DOS device driver header, It must be the first thing 

; in the code segment. Consult the HP Vectra MS-DOS Programmers Refer- 

, ence Manual for more information. BE SURE YOU DON'T RELEASE THE 

; HEADER AREA AS AVAILABLE MEMORY, EVEN ON AN ERROR. THE SYSTEM WILL 
CRASH IF YOU DO. 


. This is the only resident portion of the DOS driver, the rest 
, of the DOS driver is returned to DOS memory. 


MSD _HEADER 08000n,dev_strategy.dev int.” CCP2GID" -device header 


0000 FF FF FF FF + 

Boek foo} * gd otooon ‘mark as last driver in list 

0006 O1AB R + dw dev_ strategy 

0008 0106 R + dw dev_int 

000A 20 43 43 50 32 47 + db " CUP2GID" 

0012 OE [ + db 14 dup (7) Pad so it is paragraph aligned. 


subttl CCP2GID DRIVER Main entry point 


re) 
Sod dannp naan no aap OI DOI NONI OOOOIOOIIOOIIIOOOIDOIIDOOIIOIIO III IDOI IK 
; CS: Relative Data Area For Oriver 

: KXRKKKKKKKKAKAKKKAKAAKKKKAAKAKAKAAAKKAKAKAKAKAKAAKKAKAKAKKKAKKAKAKKAAKAKAKAKAAKAKAKAKKAKKAAKKK 


NNN NN NPR PYAR PID PO POP POAIA 00 A AD AO 210 AI AD 20 AAD PO DD AO AD AD BDO PY AO BD PO AD bb bb 
& OWWWWOW DWWANRRRRA API NR BBR me eee ee OOOO OCOCOOCO OO OHDOWOO 
KHODOMNAWNAaW NOD ONOAUWIAWA = OD CONOAUIRWNH OW DONA UNAWN- OO ONOUI AWAD 


0020 7777? sav_ bx: dw ? 
0022 7777 sav cx: dw ? 
0024 7777 sav dx: dw ? 
0026 777? sav es: dw ? 
243 0028 7777 top hp_entry: dw ? 
243 , XXKKKAAKKAKAKAAAKAAKAAKAKAAKAAKAKAKAAAAAKAAAKAKAKAAKAAAAAAKAKAKAKAKAKAAAKAKAAKAKAKAAAAKKAKAAKAKKAK 
at ; This is the EX-BIOS installed driver CCP2GID0. 
246 ; KXXKEAKAKAKAKAKAAKAAKAKAAKAAKAKAKAAKAKKAKAKAKAKKAKAKAKEKAAKAKAKKAKAKKKAAKAKAKAKAKKAKKKKKAKAEAKAKKKAKKAK 
247 002A CCP2GID_DRIVER PROC FAR 
248 002A 80 FC 00 cmp ah,F_ISR ,Is the function F_ISR? 
249 0020 74 0B je short CCP2GID_ISR 
OO2F 80 FC 02 cmp ah,F_ SYSTEM :Is the function F_SYSTEM? 
0032 75 03 jne CCP2GID_ UNSUPPORTED 
0034 €9 0100 R {mp CCP2GID_SYSTEM 
0037 CCP2GID_UNSUPPORTED: 
0037 B4 02 mov ah, RS UNSUPPORTED ‘This driver doesn't support 
0039 CF iret -any other functions. 
003A CCP2GID_ DRIVER ENDP FAR 


subttl] CCP2GID_isr function 


; S@eDRIVER HEADER sees veasusecesasnseesensesenesesesueeaeses eee ees eee 


NAME : CCP2GID_ISR 


; DESCRIPTION: This function translates valid ISR event record into 


mouse ‘yee movement or button reports, calls its parent driver 


with an ISR Event Record and then returns to the calling 
: driver with a return status of RS DONE 
: PARAMETERS 

ISR Event Record of type T_KC_HP_CCP 


; ON ENTRY: 
‘ BP = V CCPGIO 

DS » this drivers data segemnt 
AH » 0 ( F_ISR ) 


; CALL PARENT: ISR Event Record of type T_REL16 or T_KC_BUTTON 
; T RELIG: AH = 0 { F_ISR ) 
8 


: BX = ax 3 value 
; CX = axis 1 value 


X axis or Col )} 
Y axis or Row ) 


RRND PRA PRIPDDPRO ROR RI RID PD ROAD ROADD PROPRIA NPP POPP PO PO PD 
00 OD CB EDDA DBADAMD SDBOUIMUUNUNUNUTUN UN UN 
NH OO ONODU AWN OO 8 NOUAWAN HOO © NOAUAWN- O 
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283 : OH «= 41H ( T_RELI6 ) 
284 —ES:0 = describe record of V_CCPGID 
285 DL = V_CCPGID/6 
286 : 
287 : T_KC_BUTTON: AH = 0 F_ISR ) 
288 ; BL = 000H - break Button tI 
289 OOLH - break Button 2 
290 0O80H - make Button 1 
2901 O8iH - make Button 2 
292 : OK = T_KC_ BUTTON 
293 CX = 6 
294 ES:0 = this device describe record 
295 = V_CCPGID/& 
296 ; 
297 : ON EXIT: 
298 : AH = RS DONE 
299 
300 ; REGISTERS ALTERED: ax, bp and ds 
aon om eRe A BASU ERED ECE RE SESE SEER ERE SEERA RSS EE AReSEE EER EseEESeseaeeseseESS 
303 003A CCP2GID_ISR label near 
304 
305 003A 50 push ax 
306 003B 2E: 89 1E 0020 R mov word ptr cs:sav_bx.bx .save the keyboard's isr 
307 0040 2E: 89 OE 0022 R mov word ptr c8:sav_cx.cx 
308 0045 2E: 89 16 0024 R mov word ptr cs:sav_dx,dx 
ave OO4A 2€: 8C 06 0026 R mov word ptr ct: sav _es es 
1 
311 QOO4F 8C DA mov dx ,ds ;point to the mouse isr 
ath 0051 8E& C2 mov es dx 
1 
314 0053 32 FF xor bh. bh >translate the scancode to GID 
315 0055 83 FB 60 cmp bx, 60H ,check for cursor up 
316 0058 74 je short ccp_up 
317 005A 83 FB 61 cmp bx 61H :check for cursor left 
318 005D 74 24 je short ccp_left 
319 OOSF 83 FB 62 cmp bx, 62H ,check for cursor down 
320 0062 74 27 je short ccp_down 
321 0064 83 FB 63 cmp bx .63H ‘check for cursor right 
322 0067 74 2A je short ccp_right 
323 00690 80 £3 7F and bl ,O7FH 
324 006C 83 FB 68 cmp bx ,68H -check for INS or button 1 
325 OO6F 74 3E je short ccp_ but] 
326 0071 83 FB 68 cmp bx, 69H .check for DEL or button 2 
327 0074 74 3E je short ccp_but2 
328 0076 B84 06 mov ah, RS DONE .recieved an unsupported key 
aan 0078 EB 7B 90 jmp exit Tar 
331 0078 ccp_up: 
332 0078 BB 0000 mov bx 0 .no movement on the X-axis 
333 OO7TE BS FFF8 mov cx,-8 -industry standard upward move 
ae 0081 EB 18 jmp short rel move 
336 0083 ccp left: 
337 0083 BB FFF8 mov bx,-8 Negative move on the X-axis 
338 0086 89 0000 mov cx,0 ;ho movement on the Y-axis 
aie 0089 EB 10 jmp short rel move 
341 008B ccp_down: 
342 0088 0000 mov bx 0 :no movement on the X-axis 
343 OO8E B9 0008 mov cx, 8 .andustry standard down move 
aas 0081 08 jmp short rel move 
346 0093 ccep_right: 
347 0093 BB 0008 mov bx 8 move right on the X-axis 
348 0086 B88 0000 mov cx,0 :no movement on the Y-axis 
on 0099 EB 00 jmp short rel move 
351 0098 rel move: 
352 009B 89 1E C028 mov ds D REL X,bx ;save new relative move (X 
353 QOOF 89 OF 002A mov ds O REL Y,cx ,save new relative move ty} 
354 OOA3 O1 1E 0024 add ds D_ ABS X.bx .$ave new absolute position er 
3§5 OOA7 O1 OF 0026 add ds D ABS Y.cx ;8ave new absolute position {(Y 
356 OOAB B6 41 mov dh.T RELT6B 
ee OOAD EB 3C jmp short give_to_parent 
359 OOAF ccp_butl: 
360 OOAF BB 0000 mov bx 0 -button one got pushed 
acs 00OB2 EB OS jmp short but process 
363 0084 ecp_but2: 
364 0084 6B 0001 mov bx 1 ,button two got pushed 
Aas OOB7 EB 00 jmp short but process 
367 0089 but process: 
388 00B9 88 0001 mov ax ,0001H get the proper bit set in 0 STATE 
369 OOBC 8A CB mov cl.bl = 
370 OOBE D2 £0 shi al,cl 
371 00CO A2 O01C mov byte ptr ds: D_TRANSITION al :record in the describe record 
ote which button changed 
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374 00C3 2E: 8B OE 0020 R mov cx,word ptr cs:sav_bx get the scan code and check for 
375 00Cc8 F6 Cl 80 test cl,UP_DOWN_BIT ;push or release 
sae 0OOCB 74 06 jz but push 
378 00cD but_release: 
379 00CD 08 08 0010 or ds:D STATE al ;show the release in D_STATE by 
380 0001 EB 08 jmp short putton_ done ;setting the bit 
381 
382 0003 but push: 
383 0003 F6 DO not al ;show the puen in O_STATE by 
384 0005 20 06 0010 and ds:D_ STATE ,al ;clearing the bit 
ae 0009 EB 00 jmp short button done 
387 00DB button_done: 
388 OODB 2E: Al 0020 R mov ax,word ptr cs:sav_bx ;was button pushed or released? 
389 OODF 24 80 and al ,080H 
390 Q00E1 OA D8 or bl,al ;record in bx 
391 OOE3 32 FF xOr bh, bh 
392 OOES 33 C9 xor cu cKX 
393 OOE7 B6 09 mov dh,T KC BUTTON 
394 OOE8 EB 00 jmp short give _to_ parent 
395 
396 OOEB give_to_ parent: 
397 OOEB B4 00 mov ah,F_ISR ;Execute ISR of parent 
398 OOEO B2 1B mov ooiNe edo oe ,source vector is this driver 
399 OOEF 8B 2E O00A mov bp,ds:OH_V_ PARENT ;Get my parent's vector from my header 
400 SYSCALL 
401 OOF3 CD 6F + int HP_ENTRY 
402 OOFS exit isr: 
403 OOFS 2E: 8B 1E 0020 R mov bx word ptr cs:sav_bx ;restore to keyboard ISR state 
404 OOFA 2E: 8B OE 0022 R mov cx,word ptr cs:sav_ cx 
405 OOFF 2E: 8B 16 0024 R mov dx,word ptr cs:sav_dx 
406 0104 2€: 8E 06 0026 R mov es,word ptr cs: sav_es 
407 0109 58 pop ax 
408 OLOA 684 06 mov ah,RS DONE ‘Record on return 
rhs O10C CF iret 
1 
411 subttl CCP2GID_ system function 
412 
a ee eDRIVER HEADER semua uaw une me BRERA ER ORR E ERE E EERE KERR AE 
415 NAME: CCP2GID_ system function 
417 : DESCRIPTION: Decodes the appropriate system function, 
418 Supported Subfunctions are: SF _INIT 
419 SF START 
420 SF_REPORT STATE 
7s SF_ VERSION DESC 
423 PARAMETERS 
424 
425 ON ENTRY: 
426 
427 ON EXIT: 
428 
ane REGISTERS ALTERED: ax, bx, di, bp 
431 Dewees CAs ee OL nea eee ene ees Weed be eee be wine ees wee eewe cbc wweeeeeece 
ane 0100 CCP2GID_SYSTEM label near 
434 0100 3C 06 90 90 cmp al MAX _CCP2GID SYS FN :Is the syeten subfunction 
ane 0111 77 00 ja short CCP2GID bad sya _fn iwithin the valid range? 
437 0113 #87 EB xchg ee ;Load the jump table index 
438 0115 8A D8 mov bl,al ;into bp. 
439 O117 32 FF xor bh, bh 
rr 0119 87 EB xchg bp bx 
has O011B 2E&: FF AB 0123 R jmp cs:word ptr CCP2GID_sys_case(bp) 
444 0120 CCP2GID_bad sys _ fn: 
445 0120 B4 02 mov ah, RS UNSUPPORTED ;Return status as unsupported 
ot 0122 CF iret 
Aas CCP2GID_system subfunction jumptable 
450 0123 CCP2GID_sys case 
451 0123 O12B R dw word ptr CCP2GID_sys_init :SF_INIT 
452 0125 O147 R dw word ptr CCP2GID_ sys_ start :SF_ START 
453 0127 0120 R dw word ptr CCP2GID_bad sys _fn :SF_ REPORT STATE 
454 0129 0120 R dw word ptr CCP2GID_bad sys fn ,SF_VERSION_DESC 
tee = 0006 MAX CCP2GID SYS FN equ byte ptr ($ - CCPB2GID sys case - 2) 
re subttl CCP2GID_ system function - init subfunction 
459 
460 wee eDRIVER HEADERe se eeccesesaseescsesesasee essen esses ee se ese see saRES 
462 NAME : CCP2GID_system function - init subfunction 
48a DESCRIPTION: Initializes Deacribe Record and Exits, allocating a 
465 DS. 
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468 : 
ree ; PARAMETERS 
469 : ON ENTRY: ah ® F_ SYSTEM 
470 al = SF_INIT 
471 : bp = V_CCPGID 
pues ; bx = last used data segment 
474 ON EXIT: ah = RS SUCCESSFUL 
re bx = last used data segment - this drivers data segment 
ea REGISTERS ALTERED: ah, bp, and ds 
479 , SSSSSSSSHRSTSTFASSCSTSCSEHRSSKRTHSTETSHHASSSKRSSHRSSHSSSHKRSTCRBSBSBeeetsaeenuszaeasa 
480 
481 0128 CCP2GID_sys_ init label near 
482 012B 06 push es 
483 012C 56 push si 
484 012D 57 push di 
485 Ol12E 51 push cx 
486 Ol12F 83 EB 03 sub bx, (CCP2GID_ DESC SIZE+15)/16 
487 0132 8E& C3 mov es ,bx 
488 0134 BE 0177 R mov si,offset cs:CCP2GID_ desc_headr 
489 0137 FC cld 7 
490 0138 33 FF xor di.di 
491 013A BS 003 mov cx ,CCP2GID_DESC_SIZE 
492 0130 F3/ 2E: A4 rep move byte ptr ef: (di) ,cs:[si] 
493 0140 59 pop cx 
494 0141 SF pop di 
495 0142 5E pop si 
496 0143 07 pop es 
497 0144 B4 00 mov ah, RS SUCCESSFUL 
498 0146 CF iret 
499 
500 P 
ae (eeeDRIVER HEADER ewe see esse eee PER ERENT URE ESTER ETRE 
ae > WAME: CCP2GID_system function - start subfunction 
505 ; DESCRIPTION: Relinks the V_CCP driver to this driver, V_CCPGID, 
$06 : so this driver is activated to translate cursor control 
ca : pad reports to mouse type movements. 
08 : 
509 
ate PARAMETERS 
51 : 
$12 : ON ENTRY: AH = F_ SYSTEM 
§13 : AL = SF_ START 
514 : BP = Vv CCPGID 
515 : 
516 ; 
ee ON EXIT: AH = RS SUCCESSFUL 
oss REGISTERS ALTERED: ah, ds, bp 
§21 TITITI ITLL iret eereeeeeeeeeeeeerrereerrrre 
522 
§23 
524 0147 CCP2GID_sys_start label near 
525 0147 50 pus ax 
526 0148 JE push ds ;Save the ds register 
527 0149 B& 0000 mov ax, :Set the ds to the Int vector 
$28 014C 8€ D8 mov ds ax 
529 O14E Al O1BE mov ax,ds:((4 & 6FH) + 2) ;Get the HP_VECTOR TABLE segment 
530 0151 2E: A3 0028 R mov word ‘ptr cs:top_hp_ entry, ax 
531 0155 8€ D8 mov ds 
§32 0157 Al 0052 mov ax. de: [V _CCP +4) ;Get the top of the header for the 
$33 O15SA 8E D8 mov ds, ;V_CCP driver 
534 01SC C7 06 000A oan? mov ds: (DH, Vv Seve k V_CCPGID ;Have V_CCP point to 
535 0162 2E: Al 0028 mov ax,word ptr cs:top hp_entry ;load ds with HP "VECTOR _ TABLE segment 
536 0166 8E D8 mov ds. ax 
§37 0168 Al 00D0 mov ax,ds:[V_LHPMOUSE +4] :Point to the top of RAM for the mouse driver 
538 016B 8E D8 mov ds ,ax 
539 016D C6 06 004C 02 mov byte ptr ds:MSE NUM_BUTTON, 2 ;Define the number of buttons to 2. 
§40 0172 IF pop ds ;Restore the ds 
§41 0173 58 pop ax 
§42 0174 B4 00 mov ah, RS SUCCESSFUL 
che 0176 CF iret 
545 subttl DOS-Install Code ( Returned to DOS ) 
546 
547 0177 RETORN THE FOLLOWING RAM_TO_DOS label far 
548 ; temporary EX-BIOS Header configuration template 
549 
550 0177 £608 CCP2GID_ desc _headr HP_SHEADER <CCP2GID_HP_ATTR ,V_CCPGID/6 ,V_CCPGID ,Ci_CCP,CL_LGID 
,V_LHPMOUSE ,V_DOLITTTE> 
551 0179 0018 
552 017B O0A2 
553 017D 2000 
554 O17F 0020 
555 0181 o0OoCcCc 
556 0183 0006 
557 0185 00 
558 0186 00 
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559 

560 0187 CCP2GID_desc: 

561 0187 OF b OFH :D_SOURCE 

562 0188 00 db 0 :D_HPHIL IO 

563 0189 00 db 0 -D_DESC_MASK 

564 018A 00 db 0 :-0_I10_ MASK 

$65 018B 00 db 0 :-D_XDESC_ MASK 

566 Oo18C 02 db 2 O MASK AXIS 

567 0180 00 db 0 D_CLASS 

568 O18E 20 db 020h 0 PROMPTS 

$69 O18F 00 db 0 D_RESERVED 

§70 0190 00 db 0 D_ BURST LEN 

571 0191 00 db 0 D WR REG 

572 0192 00 db 0 0 RD REG 

§73 0193 O11 db 1 Due ene tT TON 

§74 0194 FF db INIT BUT_STATE <:D_STA 

575 0195 00C8 dw 200 ;D_RESOLUTION 

5786 0197 0000 dw 0 ;D_ SIZE_X 

577 0189 0000 dw 0 ,O_SIZE_ Y 

578 019B 0000 dw 0 :D_ABS X 

579 018D 0000 dw 0 :0_ABS_Y 

580 O19F 0000 dw 0 ,D_REL X 

§81 C1Al 0000 dw 0 ,D REL Y 

582 01A3 0000 dw 0 ;D_ ACCOM _X 

oe OLAS 0000 dw 0 ;D_ACCUM_Y 

58s ,BSRSSKSSSTEATTSARSSSSSSCHRTSSERKASSRSERAKSSHSASSRSSSTHAATHERSRSRESARSSEeesesess 

5286 ; This completes the MS-DOS device driver section : 

rea ; and begins the HP device driver code. (section 2) : 
‘RB SRS SSBRSKRSCARRESHSKRERERSSRPSKRSETCSSRASVSERBSSTESESSHKUSRERUESESSHRHERSKRESHEBARBESHBEBHEBBBASS 

589 O1A7 7777? rh_off dw ? ;request header pointer offset 

590 O1A9 7777 rh_seg dw ? ;request header pointer segment 

$91 , SSSSSSSRTASSSTSSASHSTRERSKTSSKRSAKHERKSSSHSSRESERKESSESSSESSASSeeseaeeee 

592 ; device ape Piedacocs by MS-DOS 3.1) : 

593 : save es bx dress of request header} and return P 

§94 , SSSSSSSKRTTESESTSSASSSASSSSSCSSSHSSSSSCSSSHSSSCSESRSSRSKT ASSES esesasseusases | 

ae O1AB dev_ strategy PROC FAR 

507 O1AB 2€: 89 1E O1A7 R mov cs: rh_off bx ;save offset of request header ptr. 

598 O1B0 2E: 8C 06 OLAS R mov ce:rh_seg,es ‘save segment of request header ptr. 

399 0185 CB ret 

600 01886 dev_ strategy ENDP FAR 

601 , SSRSSRSCASERTTTASESSSATTSE BATTS SUT ARS TESC RTS T HRS ase seseaesesasesasacs 

602 ; device interrupt Oe ba als bY MS-00S 3 1) 

603 ‘ use the command from the request header block as an index 

604 : into the table of command processing routines. ‘ 

605 , SPUN ETERS RSTSSSSSASSSRSS ETERS VSSSESTSSESCTERSHSSSSATSRERSRRARESHSRSSS 

608 0186 command table label word 

607 _ RS SSSRATCSRSATRETSESSERTTSTESSSASTSSRTESSSTEETTHATKRHSESESESERAESeRs esses 

608 0i1B6 0286 R dw init ‘initialization 

609 O1B8 0213 R dw media check ‘media check (block only) 

610 O1BA 0213 R dw build bpb ‘build bpb block only) 

6ll 01BC 0213 R dw doctl in ;foctl] input 

612 OL1BE 0213 R dw input ;input (read) 

613 01CO0 0213 R dw nd input -non-destruct. read (char only) 

614 01C2 0213 R dw in_stat -input status eee only) 

615 01C4 0213 R dw in flush :input buffer flush char only) 

616 01CB 0213 R dw output -output (write) 

617 01C8 0213 R dw out verify soutput (write) with verify 

618 C1CA 0213 R dw out stat ‘output status char only 

619 O1CC 0213 R dw out flush Siok buffer flush (char only 

620 O1CE 0213 R dw ioctl out ioctl] output 

621 0100 0213 R dw dev_open ;device open 

622 0102 0213 R dw dev close ,device close 

asd O1D4 0213 R dw rem media ‘removable media 

625 , SR SSSSTSTSTSSSSSESHSSSURAASHT EHH ATeSHeSesBvessssuseeeseasensseseseesueses 

any 0106 dev_int PROC FAR 

628 0106 9C pushf 

629 0107 FC cld spreserve machine state 

630 0108 60 pusha 

631 0109 IE push ds 

632 010A 086 push es 

633 ; DOS is CS 

634 01DB OE push cs 

ee o1pc «IF pop ds 

637 0100 C4 36 O1A7 R les si, eg es tr ds. clo off} :loads es:si 

638 OLEL 26: 8A SC 02 mov bl, tai). MSD _ :get function byte 

639 O1E5 80 FB 00 cmp bl, MSD INIT ;quit if lower than 

640 Ol1E8 72 11 jb bad cmd ‘lowest command number 

64) OLEA 80 FB OF cmp bl, “ASD REM MEDIA ;quit if higher than 

ane O1ED 77 0C ja bad _emd ; highest command number 

4 ' 
aS ; command is valid; go do it 
4 

646 OlEF 32 FF Kor bh, bh 

647 OLFi Dl &3 shi bx 4 :make BX offset into table 

648 O1F3 2E€: FF 97 0186 R call word ptr cs:command table[bx] 

ons C1F8 EB 10 90 jmp int_exit 
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651 - unknown command routine 
632 bad cmd: 
bea OIFE C4 36 O1A7 R ~ ‘les si,dword ptr da:[(rh_off] ;reload es:si w/ header addr 
mov al .MSD_UNKNOWN CMD 
bee 0201 Ba ot mov ah,MSD_ERR_ STATUS ;status word now in AX 
657 0203 26: 89 44 03 mov es {si] MSD_STATUS. ax -place in request header 
658 0207 EB O01 90 jmp int_exit 
a 659 
660 all finished 
| be 020A int exit: 
$63 020A C4 1E O1A7T R ~ les bx ,dword ptr ds:[rh_off}) ;reload es:bx w/ header addr 
664 O20E 07 pop 6s 
665 O20F iF pop ds ,restore all preserved registers 
666 0210 61 popa 
SEE BB nt 
668 re 
669 0213 dev_int ENDP FAR 
670 ; 
671 , SS SSTCSSSSHSSSSSUAHRSSTSASSTSETETSSSSSSRASSSSSSTESSSSSSRSSSCSESSHSSESSRESSRASSSES 
672 ; All MS-DOS functions except init are unsupported and do nothing. 
673 , SS SPETSSSSKSSSESSSSSSSSSTSSSASTSSEHSSSSSSSSSSHHARESSSEETSRSRSesessesaessesus 
674 0213 unsupported PROC NEAR 
675 , SS SSSSSSSSSASSSSSSSSSSSSSSHTSSSSSSSSSSHSSSSSSSSSssssessesesesssaegsassssessa | 
676 0213 media check: 
677 0213 build bpb: 
678 0213 loctl_ in: 
679 0213 input: 
680 0213 nd_input: 
681 0213 in_atat: 
682 0213 in flush: 
683 0213 output: 
684 0213 out verify: 
685 0213 out stat: 
686 0213 out flush: 
687 0213 doctl out: 
688 0213 dev_open: 
689 0213 dev_close: 
690 0213 rem_ media: 
691 0213 all_ok: 
692 0213 32 CO xor al,al ;0 indicates OK 
693 0215 B4 01 mov ah,MSD DONE STATUS 
694 0217 C4 36 OLA7 R les si,dword gtr de:(rh_off} :reload es:si w/ header addr 
695 O21B 26: 89 44 03 mov es:({si]) MSD STATUS, ax :return ok status 
696 O21F C3 ret 
697 0220 unsupported ENODP NEAR 
a 698 
‘ 699 page 
. 700 , BSS SSSR SSH STA STATA SSSR STARR RTS SPSS RHR EERE T ORT E RRR REE 
yet ; dnit  - setup variables & establish link in HP_VECTOR_ TABLE : 
703 0220 48 50 20 43 43 50 init msg db “HP CCP2GID installed driver 2.2" ,0dH,OaH,"$" — 
704 32 47 49 44 20 69 
70S 6E 73 74 61 BC 6C 
706 65 64 20 64 72 69 
707 76 65 72 20 32 2E 
708 32 0D OA 24 
709 0242 48 50 20 43 43 50 init _msg2 db "HP CCP2GID installation failed” OdH,OaH, "$" 
710 32 47 49 44 20 69 
711 6E 73 74 861 6C 6C 
712 61 74 69 6F 6E 20 
713 66 61 69 6C 65 64 
714 0D OA 24 
715 0263 48 50 20 43 43 50 init msg3 db “HP CCP2GID installation suceeded” OdH,0aH, "$" 
716 32 47 49 44 20 69 
717 6E 73 74 61 6C 6C 
718 61 74 69 6F 6E 20 
719 73°75 63 65 65 64 
720 65 64 0D OA 24 
72) , SR SSSR aS SSS SSS SSS STS ASEH SSHSRSRTSTS SSSR SSSR E SERRE e ERAS Es ERE EEE see 
122 0286 init PROC NEAR 
724 0286 FA cli : 
725 : 
728 Put next available memory location in System Request Header 
728 0287 Ca 36 O1A7 R les ti,dword Bik da:(rh ont} ;es:si := header addr 
729 028B 8D 06 0177 R lea ax,cs: RETURN THE FOLLOWING RAM TO DOS’ -:put next free loc 
730 O28F 26: 89 44 OE mov es:word ptr [si] MSD _ENO_OFFSET, ax ‘address in header 
731 0293 8c C8 mov ax,cs 
734 0285 26: 89 44 10 mov es:word ptr [si).MSD_END_ SEG, ax 
734 ; Put the driver into the HP_VECTOR TABLE 
736 0299 OF push cs 
737 029A 07 pop es 
738 install (init ) V_CCPGID 
741 02988 B4 OE mov ah, F_INS FIXGETOS ; Puts the driver in HP VECTOR TABLE 
742 029D BB 00A2 mov bx, V_CCPGID ; and calls to do F_SYSTEM+¢SF YNIT 
743 02A0 8D 3E 002A R lea di, CUP2GID_DRIVER ~ 
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744 O2A4 1€ 
745 
746 02A5 BO 
747 02A8 CO 
748 O2AA IF 
749 
7590 O2AB B84 
7§1 02AD B60 
782 O2AF 1€ 
753 
754 0280 BD 
755 02B3 CD 
756 0285 =#IF 
757 
758 02B6 84 
759 0288 BO 
760 
761 02BA BD 
762 02BD CD 
763 O2BF IE 
764 02CO OE 
765 o2cl IF 
766 
767 Q2C2 860 
768 02C6 B4 
769 02Cc8 CD 
770 O2CA IF 
771 02CB FB 
772 o2cc 6€E9 
773 O2CF C3 
774 0200 
775 
776 0200 
777 
Macros: 

N 
MSO HEADER 
SYSCALL. . 


0012 
6F 


16 0220 R 
09 
21 


0213 R 


Structures and records: 


N 


DESCRIBE 


XDESC_MASK 
“MAX_AXIS . 


“RESERVED . 

_BURST_LEN. 

R REG. . 
~REG 

“TRANSITION 

Tie aa : 


tet toto I 
BaRaRBCras Ss 
! are 
Be 


| 
\ 
ae 


OMMD WHIM —4 
Or°rrlOAONN 


sft ft so ts Ds i Bf TT 
cq 


~ACCUM_Y. 
HP_SHEADER . 
DH_ATR 


DH_NAME_ INDEX. 
OH~V_DEFAULT 
OK_P_CLASS . 
DH_C CLASS . 
OH_V_PARENT. 


CMD 
MSO_UNTT COUNT 
MSD_END OFFSET 
MSO~END_SEG. 
MSD_BPB_OFFSET 
MSO_BPB_SEG. . 
MSD_1ST UNIT 

MSD_REQ HEADER 
MSD_CMOLEN 
MSD_UNIT 
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push ds 
syscall V_SYSTEM 


; start BE cpap’ 


mov ah, F SYSTEM 
mov at SF_START 
push 


syscall rh CCPQID 


.V_SYSTEM 
N 


.V_CCPGID 
ENT 


° ds 
: iaedais bp Mouse Driver whether there is an HP Mouse or not 


mov ah,F IO CONTRO 
mov al,SF_ MOUSE OVERRIDE 
syscall V_LHPMOUSE 


bp. V_ LHPMOUSE 
"ENTRY 


; write a message on flee saying driver installed 
msg 


push ds 
push cs 
pop ds 
lea dx, init_ 
mov ah, 
int 21H 
pop ds 
sti 
imp all ok 
re 

init ENDP NEAR 

CODE ends 
end 

Length 

0006 

0002 

Width @ fields 

Shift Width Mask 

0030 0018 

0010 

0011 

0012 

0013 

0014 

0015 

0016 

0017 

0018 

0019 

OO1A 

0018 

001C 

0010 

OO1E 

0020 

0022 

0024 

0026 

0028 

002A 

002C 

002E 

0010 0009 

0000 

0002 

0004 

0006 

0008 

000A 

000C 

OO00E 

OOOF 

0017 0007 

000D 

0O00E 

0010 

0012 

0014 

0016 

0016 000A 

0000 

0001 


-all linked so all finished 
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MSD CMD... 7... 0002 
MSD STATUS... ...... .. 0003 
MSD MEDIA... . .. . 2... 0000 
MSD_TRANS... . . . . . OO00E 
MSO_COUNT.. . . . . . . 1d, 0012 
MSD_START. . > ss 0014 


Segments and Groups: 


Name Size Align Combine Class 
CGROQUP: 4-4. 4 ae hm Se ee tee Bg GROUP 
CODES 2, fb 2. gh tal ee GS a ye A, 0200 PARA PUBLIC ‘CODE’ 
Symbols: 
Name Type Value Attr 
ALL_OK . See ey: A Oe Bie net L NEAR 0213 CODE 
ATR_CSHARE ee ee ee Oe Number 0008 
ATR _DEVCFG. ...... . 2... Number 4000 
ATR AP af 4 we GS ote oh et Number 8000 
ATR_ISR Number 2000 
ATR_LOG Number 0600 
BAD CMO. NEAR O1FB CODE 
BUILD BPB. NEAR 0213 CODE 


L 
: L 
BUTTON DONE. L 
BUT_ PROCESS... ..... . L 
BUT PUSH i: oop See ge A ge ae we a a L NEAR 00D3 CODE 
BUT RELEASE . a ee ae ae L 
CCPZGID BAD SYS “FN : 
L 


CCP2GID DEST. NEAR 0187 CODE 
CCP2GID_DESC_HEADR .... .. . 0010 0177 CODE 
CCP2GID DESC SIZE... . . . . . Number 0030 
CCP2GIO ORIVER........ . F PROC 002A CODE Length s0010 
CCP2GID HP_ATTR. ... . . . Number E608 
CCP2GID_ INSTALLED. ...... . L FAR 0000 CODE 
CCP2GID_ ISR. . * 24ers Boe S L NEAR 003A CODE 
CCP2GID SYSTEM . L NEAR 0100 CODE 
CCP2GID_ SYS CASE L NEAR 0123 CODE 
CCP2GIO SYS INIT . L NEAR 0128 CODE 
CCP2GIO SYS START. ........ L NEAR 0147 CODE 
CCP2GID UNSUPPORTED. me. W858 t NEAR 0037 CODE 
ccPp_BuT!T t~ Ae di, ee th L NEAR OOAF CODE 
CCP _BUT2 L NEAR O0B4 CODE 
CCP_DOWN L NEAR 008B CODE 
CCP_LEFT . L NEAR 0083 CODE 
CCP_RIGHT. L NEAR 0093 CODE 
CGP "UP 2a we Oe a KE L NEAR 0078 CODE 
CL ACOP ak Bick. imi So Ue ce (des Ge ee UY Number 2000 
CL LGID. . de yeep? ey ei A ak, oe Number 0020 
COMMAND TABLE. es de My ee, ak. WB Ne ed L WORD 0186 CODE 
DESCRIBE SIZE. ......... Number 0030 
DEV CLOSE eg a. ee ek L NEAR 0213 CODE 
DEVSINT «ged bow, Bem, a. Se RE F PROC 0106 CODE Length #0030 
DEV_OPEN.... . 2... 2 L NEAR 0213 CODE 
DEV STRATEGY... . . 2. F PROC 01AB8 CODE Length #000B 
D ADDR MASK. .......... Number O00F 
O BUFFER ...........~, Alias D_SIZE_X 
aaa STATE. ee ee ee ae Number OO1E 
0 CLASS _ CURRENT. of sts par fn a, Whe ae Number O0FO 
OD CLASS DEFAULT. ......... Number OOOF 
DT-REMAINDER ACCUM. .... Alias 0 _ACCUM_X 
D™SAMPLE ABSOLUTE. ...... . Alias DABS X 
D_ SAMPLE RELATIVE. ...... . Alias D_REL X 
D SIZE... ee Sess Her Ake aoe 2 eh Alias D SIZE x 
D vce eask Number 0O0OFO 
EXI L NEAR OOFS CODE 
F INS. P EXGETDS Number OO0E 
FIO TONTROL Number 0004 
oe | eee ee Sereay Seton a Number 0000 
F SYSTEM Bice oe we Oe ee ge Number 0002 
GYVE TO PARENT ........, L NEAR OOEB CODE 
HP ENTRY me Oh te, get eee ae Number 0O06F 
INIT enh th: ee Bed ee ae N PROC 0286 CODE Length #004A 
INIT BUT STATE te My Se uae “abe ak ued fA, Number 0OOFF 
INIT MSG... . . 2... ee, L BYTE 0220 CODE 
INIT MSG2. eo ot, at ha L BYTE 0242 COOE 
INIT MSG3. L BYTE 0263 CODE 
INPUT. L NEAR 0213 CODE 
INT EXIT L NEAR O20A CODE 
IN_ FLUSH L NEAR 0213 CODE 
IN STAT L NEAR 0213 CODE 
IOCTL IN : L NEAR 0213 CODE 
IOCTL Tout. : L NEAR 0213 CODE 
MAX COP2GID SYS_ “FN E BYTE 0006 
MEDIA CHECK. . eo we te ts ee, tx L NEAR 0213 CODE 
MSD _DUNE STATUS. tee Meh Cie Cape ee Number 0001 
MSD ERR STATUS .......... Number 0081 
MSO_INIT . BRS ts. Lie Ac BT Selo Number 0000 
MSD REM MEDIA. Uo tte oN a. ath ape Minn Bie aa Number OOOF 
MSD_UNKNOWN CMD... ..... Number 0003 
MSE NUM BUTTON. ........ Number 004C 
NO INPUT .........2.2. L NEAR 0213 CODE 
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OUTPUT . . 
OUT FLUSH. 
OUT STAT . 
OUT_VERIFY 
REL MOVE 

REM MEDIA. 


RETURN _THE -FOLLOWING_ RAM_TO_DOS. 


RH_ OFF 

RH SEG . 

RS DONE. . 

RS SUCCESSFUL. 
RS UNSUPPORTED 


SF _MOUSE OVERRIDE. 
SF_START~ ae 
7OP. MP ENTRY 

T_KC BUTTON. 
TRELIG. . 
UNSUPPORTED. 

UP DOWN BIT. 

vitce. | 
VICCPGID . 
V_DOLITTLE 
V_LHPMOUSE 
V_SYSTEM 


43048 Bytes free 


Warning Severe 
Errors Errors 


ALL_OK . . 
ATR_CSHARE 
ATR_DEVCFG 
ATRTHP .. 
ATR_ISR. 
ATR_LOG. 


BAD CMO. . 

BUILD BPB. . 
BUTTON DONE. 
BUT PROCESS. 
BUT PUSH _ . 
BUT_RELEASE . 


CCP2GID_BAD SYS FN 
CCP2GID-DEST . 
CCP2GID_DESC_HEADR 
CCP2GID DESC SIZE. 
CCP2GID_DRIVER . . 
CCP2GID_HP ATIR. . 
CCP2GID_INSTALLED. 
CCP2GID_ISR. .. . 
CCP2GID SYSTEM . 
CCP2GID_SYS_ CASE 
CCP2GID_SYS_INIT . 
CCP2GID_SYS_ START 


CCP2GID UNSUPPORTED. 


CCP_BUTT 
CCP_BUT2 
CCP_DOWN 
CCP_LEFT . 
CCP_RIGHT. 


COMMAND TABLE. 


DESCRIBE... 
DESCRIBE SIZE. 
DEV_CLOSE. .. 
DEV_INT. 
DEV_OPEN . 
DEV STRATEGY 
DH_ATR 
DH_C_CLASS 
OH_MAJOR . 
OH_MINOR . 
DH NAME INDEX. 
OH~P CLASS . 
OH_V_CHILD . 
DH_V_DEFAULT 
OH_V_PARENT. 
D_ABS xX. : 


458 _ Driver Writer’s Guide 


SOaOW SNOOP NAW OO 
Seeoeensae 


~DOOOW @28@arD00 WArF- OOF 
a 


Ne aU WWW ae 


NG) WW) WG) GPRD 


SOONUMMNAMNMAMAUWUI ANNAN eE SN COONWNOR, NE MAP UT 
ee 


a@n 
sec. 8 06©f 


NON Ae 
Bare VNOADWO™N& ONa~ AWWA VION 08 Oo NUT 


- 


ccc rcrrece 
z 
mn 
> 
P-) 


Number 
Number 


MAa@@Od &—-& BNUU WOWWUWUA 
es 


SCane —- POUT WaWaQ@uuwt 
WMWeoe@o  ewea@acocd - a@rwwow 


| at 7° 
-— Oo 
ow 


455 


206 


114 


669 
600 


Qu 
Ww 
>a 


CODE 
CODE 
CODE 
CODE 
CODE 
CODE 
CODE 
CODE 
CODE 


CODE 
CODE 
CODE 
CODE 


CODE 


CODE 


454 


207 


Length #000D 


776 


CCP_ TO __GID__FILTER 


355 
120 


TBURST LEN. 
TCCP_ STATE. 
“CLASS. 

CLASS CURRENT. 
TCLASS DEFAULT. 
DESC MASK. . . 
H 


> 
Oo 
oO 
7» 
* “W- * . 
x 
ed ee do 


Shield teeta at 


352 


= 
m 
Fie. 
xe 
> bbe 
Gm 
Up 
Ww eo 


EL 
-REMAINDER _ACCUM., 
_RESERVED 
RESOLUTION 
SAMPLE _ABSOLUTE 
daa REED: 
117 121 


fis tt i 


ss pad pata ta wat hel sho 


8 379 384 
D~ TRANSITION 1 

O_TYPE MASK. 
D "WR REG. . 
0” XDESC_MASK 


EXIT_ISR 
F_INS FIXGETDS 
F_IYO CONTROL 
FTISR. 
F_SYSTEM 
GIVE_TO_PARENT 


HP_ENTRY . 
HP SHEADER 


ww 


397 
750 


0 
4 
5 
4 
5 
94 3968 
0 
5 
2 
7 
6 


ho ee bo be 
oe oe 


w& 


7T47 755 762 


1 
8 78 
28 «774 
IT BUT STATE 4 
IT_MSG.. . 7 

IT MSQ2. 
IT-MSG3. 

PUT. |. 

INT EXIT 

IN FLUSH 

INC STAT: Sieh ove ee ees 
IOCTL_ IN... 8D 


TOCTEOUV 2 eee BA Oe wm ee 620 687% 


MAX CCP2GID SYS FN... ... . ~~ 434 4558 
MEDYA CHECK, .- . . . . . . . 609 6768 
MSO_IST UNIT... . | |) 1) 47 be 
MSO_BPB_OFFSET ... . . . . . .s«O4:728 
MSD BPB SEG... . .. . . 38 
MSD_CMD_ 

MSD CMOLEN 

MSD COUNT. |. 
MSD_DONE STATUS. 
MSD_END OFFSET 
MSD_END SEG. . 
MSD_ERR STATUS 
MSD HEADER _ . 
MSD_INIT . 
MSD_INIT_CMD 
MSD MEDIA. . 
MSD_REM MEDIA. 
MSD_REQ HEADER 
MSD_START. |. 
MSD_STATUS 
MSD_TRANS. 
MSD_UNIT 
MSD_UNIT COUNT . 
MSD_UNKNOWN_CMD 
MSE_NUM BUTTON 


ND_INPUT 


OUTPUT 
OUT FLUSH. 
OUT STAT . 
OUT VERIFY 


REL MOVE . 
REM MEDIA. 


IN 

IN 
IN 
IN 
IN 
IN 


6626 


& WFO A UI ®O W “098 oo ~ Ne Oc © DO Hh POA U1 HO OO WTO DM ODOR ogo @ UWA) D @ Oe UI ON 


” 
ae] 
™N 
nm 
=< 
@aeaer%“1anxnn~~—@ b= pmo peo bee ae eee bee Pe pe 
eH ae Ke OODO a2oeo WF WWAR NY DBDNODOCWO Or KRRKROONOCOOT qmoamaNnNNawre DONA Hr O 


CO oO a~ ~~ OP 
nr Oh ww Aww oOo 
a Ne Wo GN OW 


695 


344 349 35168 


fe 3) aemaem fe] f= pee bem fo Go fee Pe he fee be fe fb A) Po Po fe Bo bee be be ee 
NWO eRe = OND UU & SUID “IN 08 I~ Oo OB & UT 


GC & SOOd WW BwaODOO@eH- TOI aAWNAOH OO} ODO 
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RETURN _THE FOLLOWING RAM_TO DOS. 547@ 729 

RH_OFF.. .. . . . T8888) 597 637 654 663 694 728 
RH-SEG. . . |... .. 2.) >) $908 =) «S98 

RS_DONE. .. . . . . . . 2 . . . 183 = 328 408 

RS_ SUCCESSFUL. Dl 1848 887 542 
RS_UNSUPPORTED 185@ 254 445 

SAV_BX 2378 306 374 388 403 
SAV_CX 2388 307 404 

SAV_DX 2398 308 405 

SAVES... 1... 2408 309 406 
SF_MOUSE_OVERRIDE. 130@ 759 

SF-START.. . . 133@ ©6751 

SYSCALL. 400 745 783 760 
TOP_HP_ENTRY 2418 530 535 

T_KC BUTTON. 1878 393 

TIRELI8B. . 1888 3586 

UNSUPPORTED. 6748 697 

UP_DOWN BIT. 1968 375 

vV_ccP. . 1948 $32 

VICCPGID 1918 398 534 550 550 742 754 
VIDOLITTLE 1908 550 

V_LHPMOUSE 192@ 537 550 761 
V_SYSTEM . 1938 746 


158 Symbols 
54092 Bytes Free 
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G.9.2 Application Resident EX-BIOS Driver 


This example demonstrates the use of an application resident EX-BIOS driver. The driver utilizes 
the Touch Screen logical device driver V__LTOUCH, and its associated event driver 
V__EVENT__TOUCH. 


The driver utilizes V__LTOUCH to move the cursor around the screen. V__LTOUCH returns the 
current row and column address of the point the screen is being touched. The example driver in 
turn utilizes the STD-BIOS Video driver (INT 10H) to change to position of the displayed cursor to 
match the screen coordinates returned by V__LTOUCH. 


This driver also utilizes the button state data returned by V__.LTOUCH. When the screen Is 
touched (a button make) the driver changes the shape of the cursor from an underline to a box 
or full character cell. The shape of the cursor Is restored to an underline when the finger is 
removed (a button break). 


Notice in the initialization section of the code that the CS:IP of the driver's service routine 
(TOUCH__HANDLER) and the driver's DS are substituted into the V__EVENT__TOUCH vector in 
the HP__VECTOR__TABLE. The existing contents of that vector are returned by the function. The 
driver stores these values In its data area, and restores them when the driver terminates (a ‘%’ 
character Is typed at the keyboard). All HP_.VECTOR__TABLE vectors that are replaced with 
application program resident drivers should restore the original values in the vector when the 
application program terminates. 


The listing for this driver can be found in Section 4. 


G.9.3. Non-HP-HIL Input Devices 


The next program listing is an example of how to integrate non-HP-HIL input devices into the 
Input System. This driver interfaces to an RS-232 mouse. It converts data frames received from 
the mouse into GID motion and button ISR Event Records. It integrates itself into the Input 
System by calling the V__SINPUT driver once these ISR Event Records have been constructed. 


The PGID driver is the physical device driver for all devices inputting graphic motion and button 
state data. The initialization code must create a PGID driver for the V__SINPUT to pass the ISR 
Event Record. It builds a driver header and physical describe record, allocates a free 
HP__VECTOR__TABLE vector, and installs the PGID driver with V__LHPMOUSE as its parent 
driver. 


The driver is structured as a DOS installable device driver. The COM port the mouse is connected 
to can be specified in the CONFIG.SYS command line. 
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.286¢ 
.LFCOND 
PAGE 59,132 
TITLE RS-232 MOUSE DRIVER 
SUBTTL PREFACE 
MAR ARARAARARRAAEAA RARER AAA RARER RAR RARRARRAARARAARARARRR ARERR 
a a 
:# RS-232 MOUSE DRIVER EXAMPLE ; ~ 
a} n 
[MARR RARER MARR RARER REAR ARERR REAR ARERR AAR ARERR RARER 


, 
+ RRAARARARRARARAAAARAAKRRAARRARARRARARARAKRAARAARARAARRARKRARARAAARRAARRARAAHAKRE 
, 


ats DESCRIPTION . 


-RRARRARARARARAARARARAAARARARRARARARAAARARARARRARARARARAARHREAR ARR ARARARKER 
, 


; This driver illustrates the integration of non-HP-HIL devices into the 
; HP Vectra Input System. This driver supports any mouse with an RS-232 
>; interface, such as the MOUSE SYSTEMS mouse. The driver is installed as 
; an MS-DOS device driver at boot time 


:The command line DEVICE*EXAMPLE SYS [/n] should be entered in the 

;CONFIG SYS file in the root directory of the boot drive. If the optional 
;COM port number, /n is not included in the command line, the driver will 
;attempt to install the mouse on COM! If the yeaah com port number is 
;present in the command line, the driver will attempt to install the mouse 
;on that COM port number. The driver checks to make sure the port 18 present 
,and will issue an error message if a non-existent port number is specified. 


SOSTEECTECTECTOOSCSOOCTCCOSSCOCOCLCTOSCOTOCORT ESSELTE CTETECETETrererererrere 
' 


a CHANGE LOG * 


' 
sRRARARKRAARRARRARARARARARAAARARRAARRARKARKRRRARARARRRAAKRARAARRARKRRAARRARRRARARARAK 
‘ 


‘Revision A.O1.01 - 12/02/85 SMM 


RRRRARRRAARAE RA RARRRAAARRRERRRRAARRRA ARRAN EARERARRRRRRRRARRR RRR RRR 
‘ 


SUBTTL EQUATES, RECORDS. AND DATA STRUCTURES 


WWW) OO) G) & &) © POP AAD ADP AO DD PO —D bP be Bb be Pe be eb he 00 I OU Be UA 


DO ONOUIRWNH OD OND UN SWF OO O™4M| US WN O 


PAGE 


40 ARR R RA R AAA RARRARARRRARRARRRRARARARRERRRRRRARRARRARA AAA RATER RHR RRR 
41 RRMA RRA RRA RRR ARERR RARER ARR AAA RAR ARERR RAR RR RAR AERA RARA RE 
42 ; EQUATES AND DATA STRUCTURES 
43 (MAA RRARAARRAARRAARARAAAR AHA RA KRARARARAARRARARRRAARERARAAAARARAHRARKRRARAH RE 
44 RAR RRRARRAR RAR ARRARRRARA NA KARRARAAR RRA REARARARRKARAKARARARRARAR RRA 
4 
MARR ER MRR RARAKARRARRARRAD GENERAL EQUATES RARKRAKRRARARRARARKRARKRRAAK ARK 
47 
48 = 0000 FALSE EQU 0 
49 =-O0001 TRUE EQU NOT FALSE 
at s DEBUG EQU TRUE 
oe >* MS-DOS INSTALLABLE DEVICE DRIVER EQUATES, RECORDS, AND STRUCTURES ** 
3 
54 -STRUCTURES 
55 
56 REQ HEADER STRUC JInitializatidn Request Header 
57 ;structure definition 
58 0000 7? RH LENGTH DB ? aan ae of Request Header 
59 oool ?? RH UNIT CODE OB ? ;Unit code. 
60 0002 77 RH CMD CODE DB ? -Command code. 
61 0003 7777 RH STATUS Ow ? ‘Returned status. 
62 0005S) = 777777777777777? RH RESERVED DQ ? ‘Reserved for MS-DOS. 
63 O0O0D 7? RH UNIT CNT DB ? ,Unit count 
64 OOOE 7777 RH END_OFF OW ? /Offset of ending address. 
65 0010 ?7?? RH END SEG OW ? a eee of ending address. 
66 OO12 7777777? RH BPB DD ? BPB Pointer (not used). 
oe OO\6 ?? RH DRIV DB ? ‘Drive code (not used). 
cs 0017 REQ HEADER ENOS 
71 # 0012 RH_CMO_LINE EQU DWORD PTR RH BPB ,On INIT entry, points to CONFIG SYS 
es ;command line (i.e. all after DEVICE=). 
3 
ie -RECORDS 
ie ATTR RECORD DEV:1, IOCTL 1, I8M.1, X:1, OCREM:1, ¥:6, SPEC.1, CLK:1, NUL.1, STOO 1. STDOI:1 
78 DEV = I for character device, O for block device. 
79 IOCTL = 1 if IOCTL commands are eng g ied: 
80 ;IBM = | if block device is in non-IBM format. 
81 X = Not used. 
82 OCREM = 1 if character device Supe tt open and 
83 close commands, 1 if block device has 
84 : removable media. 
85 -Y¥ = Not used 
86 SPEC » 1 if INT 29H fast console I/O is installed. 
87 “CLK # 1 if device is a clock device. 
88 ;NUL =» 1 if device is a nul device. 
89 ;STOO = 1 if device is the Standard Output device. 
Bo -STOI = 1 if device is the Standard Input device. 
] 
aa STATUS RECORD ERROR:1, Z'5,. BUSY: 1, DONE 1, ERR_ TYPE 8 
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eau onnaonuanaeepuan 
oO 
oO 
oO 
Los] 


eonnpuupunnoneuoaenaueuua 
oO 
[=) 
oO 
~ 


Pehl pf &VIWWWWWWWWWNNARAAI DP DID be be eb be be be OO 


0000 
0002 
0004 
0006 
0008 
OOOA 
oo0oc 
OOOE 00 
OOOF 00 


0010 


oo0o0 7? 


0001 ?? 
0002 ?? 
0003 7? 
0004 ?? 
0005S ?? 
0006 77 


0007 7? 


ooo8s 7? 
0009 ?? 
COCOA 7? 
0008 ?? 
oooc ?? 
0000 7? 
OOOE 


me ee ae be be pe ee pe pee ee be fe be be Be Be he fe Pee be be ee be ee be bb be bm be me be me be be bm be Pe bb be be be be bh be be ee me ee be be be me be be be be be bo be eb bb bb 


00 00 00 60 00 09 09 00 WINNIE OMAOMMMAMMMUMUVNVNNANN a ae 
NOU RW OW © NOU AUN HOO ON OU RUN OOO NOU EBWN EOD ON DUEUN + OD ONAUEWNE OW DYNAM AWN OW ON OU WN OW 


-EQUATES 
‘Error codes. 


MSD _ WRITE PROT 


MSD_UNKNOWN UNIT 


MSD 
MSD 
MSD _CRC_ERROR 

MSD_BAD_LENGTH 
MSD _SEEK_ERROR 
MSD 


NOT RDY 


UNKNOWN CMO 


UNKNOWN MEDIA 


MSD_SEC_ NOT FOUND 


MSD_ PAPER OUT 


MSO _WRITE FAULT 


MSD READ FAULT 


MSD_GEN FAILURE 


-Commands. 


MSD_INIT 
MSD_MEDIA_CHK 
MSD BLD_BPB 
MSD_IOCTL_IN 
MSD_ INPUT 
MSD_IN NOWAIT 
MSD_IN STATUS 
MSD_IN FLUSH 
MSD_OUTPUT 
MSD” OUT VERIFY 
MSD_OUT STATUS 
MSD_OUT_FLUSH 
MSD_IOCTL OUT 
MSD_DEV_OPEN 
MSD_ DEV CLOSE 
MSD_REM_MEDIA 


‘MS-DOS equates. 


PRINT STR 
DOS_ENTRY 


,ASCII equates. 


LF 
CR 


_RRRARARHRARR 
+ 


STRUCTURES 
HP_HEADER 


DH ATR 
DHNAME INDEX 
DH_V_ DEFAULT 
DH P7CLASS 
DH_C~CLASS 
DH_V~ PARENT 
DH V-CHILD 

DH MAJOR 
DH_MINOR 


HP HEADER 


DESCRIBE 
D_SOURCE 


D_HPHIL ID 
D-DESC_ MASK 
DIO MASK 
D7XDESC MASK 
D MAX AXIS 
DUCLASS 


D_ PROMPTS 


D_RESERVED 
D_BURST LEN 
D WR REG 
DRO REG 

D TRANSITION 
D STATE 

D7 RESOLUTION 


EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


OOH 
O1H 
02H 
03H 
O4H 
OSH 
O6H 
O7H 
08H 
O9H 
OAH 
OBH 
OCH 
OOH 
OEH 
OFH 


O9H 
21H 


OAH 
ODH 


STRUC 


oOo00000000 


~ 


VVVV VV 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


OOH 
O1H 
02H 
03H 
04H 
OSH 
O6H 
O7H 
08H 
O9H 
OAH 
OBH 
OCH 


EX-BIOS DRIVER EQUATES, 


RECORDS, 


“ERROR e 
-Z = Not 
;BUSY «= 1 if device busy. 

-DONE = 1 when command completed. 

;ERR_ TYPE = Error type. See equates next. 


l1 if error condition detected. 
used. 


Returned as part of status word defined above. 


‘write protect. 
‘unknown unit 
:device not ready. 
“unknown command. 
“CRC error. 
‘bad driver 
-seek error. 
“unknown media. 
-sector not found. 
;paper out. 

write fault. 
-read fault 
:general failure. 


;Initdalize. 

‘Media check 

“Build BIOS Parameter Block 
,IOCTL input. 

‘Input from device 
;Non-destructive, no-wait input. 
‘Return status of input device 
‘Flush input buffer. 

;Output to device. 

Output with verify to device. 
Raturn status of output device. 
.Flush output buffer. 

;IOCTL output. 

Open device 

‘Close device. 

;-Removable media check. 


(BPB). 


;MS-DOS print string function number. 
-MS-DOS interrurt. 


RARRAKRAKHKAR 


AND STRUCTURES 


“HP Oriver Header. 
Driver attribute. 
Index number for driver string. 

7 
parent class. 

child class. 

number of driver's parent. 
number of driver's child. 

address of device. 

address of device. 


‘Major 
‘Minor 


-Physical describe record. 

‘Upper nibble contains GID type. 

‘Lower nibble HP-HIL address. 

Device ID byte returned by HP-HIL device. 
£222? 

-T/O descriptor eye from device. | 
‘Extended descriptor byte from device. 
‘Maximum number of axes 
‘Device class. 

‘Upper nibble contains current class. 
‘Lower nibble contain default class. 
‘Number of buttons/prompts 

Upper nibble contains number of rompts. 
‘Lower nibble contains number of buttons. 
‘Reserved. 

‘Maximum burst length. 

‘Number of write registers supported. 
‘Number of read registers 1 ale 
‘Transitions reported per button. 
Current state of buttons. 

‘Counts/cm returned by device. 
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reported by device. 


request structure length. 
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fA) be pe be Be 8 he ee 
OW WOO O CWO WOO WO Woo 
OO oO ND UI & OA © © 00 


AIK 
oOo 
Re 


203 


RODD ADR AADD PDADBP DO PO PAPO PO DO DD ADP PO ADP AD POP DO AD AD PO 


WOW WWW) &) OC) G ROAD AAD PO AO 0 DD AD AO Pe be Pe ee 
OODOANAMNMNES WN OW SOADMO AWN OW ONOMUOaWNH-O 


AO RD BORD AD BO AO AO BOD AO BO BD BO BO AO PO BD AAD DD PO AD PO A PO 
NNN NNN NSS OO MNOAMMMNOMNAMOMNMN MANN 
ODWAOM HWA OW CON MUNI SWN- OW ONO UI & UPA 


0010 
0012 
0014 
0016 
0018 
QO1A 
001C 
OO1E 


0020 
z 004C 


s 0006 


= 0012 
= 0004 
= 000A 


002A 
0000 
0002 
0004 
= 000C 


=» OOCC 
s 0002 


=» OO6F 


0009 
0040 
0041 
0042 
0043 


0000 
0002 
0006 
OOFE 
OOFE6 


0000 


0000 
0000 


0000 
0004 
0006 
0008 
OOOA 


0020 


= AC18 
0020 
0022 
0024 
0026 
0028 
002A 


277? 
277? 
2777 
22?? 
272? 
7777 
27277 
227? 


FF FF FF FF 

8000 

0265 R 

0270 R 

20 32 33 32 40 53 
45 20 


AC18 
0003 
0000 
0000 
0000 
oocc 
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D SIZE Xx DW ? 
D_SIZE~Y OW ? 
DABS X DW ? 
D7ABS_Y DW 7? 
DREL_X DW ? 
DTREL_Y OW ? 
D_ACCUM_X DW ? 
D_ACCUM_Y DW ? 
DESCRIBE ENDS 
MSE_NUM BUTTON equ O04CH 
- RECORDS 


HP_ATTR RECORD HP:1, DEVCFG:1, ISR:1, 


CSHARE:1, ROM:1, B:1 


:Maximum count along X axis in units of resolution. 
;Maximum count along Y axis in units of resolution. 


:Absolute data device X motion. 
;Absolute data device Y motion. 
sRelative data device X motion. 
‘Relative data device Y motion. 
:X axis scaling accumulator. 
;Y axis scaling accumulator. 


/Offset of number of button in mouse RAM 


ENTRY:1, TYPE:3, STR:1, MAP_CALL:1, A:1, SUBADD:2, 


-EX-BIOS driver vector addresses and driver function numbers. 


,EQUATES 
V_DOLITTLE EQU OO06H 
V_SYSTEM EQU 0012H 


FINS BASEHPVT EQU 04H 
F_INS_XCHGFREE EQU OAH 


V_SINPUT EQU OO2AH 
F_ISR EQU OOH 
F_ SYSTEM EQU 02H 


F~IO_ CONTROL EQU 04H 
F INQUIRE ENTRY EQU OCH 


V_LHPMOUSE EQU OOCCH 
SF_MOUSE OVERRIDE EQU 02H 
HP_ENTRY EQU 6FH 


;ISR Event Record data types. 


T_KC_BUTTON EQU 09H 
TTRELOB EQU 40H 
TTREL16 EQU 41H 
T_ABSO8 EQU 42H 
T_ABS18 EQU 43H 


-EX-BIOS Return Status Codes 
RS SUCCESSFUL EQU OOH 


RS_UNSUPPORTED €QU 02H 
RS_DONE EQU O6H 
RS FAIL EQU OFEH 


RS_NO_VECTOR EQU OF6H 


;DOLITTLE driver vector address (NUL driver). 
;SYSTEM driver vector address. 


;INPUT driver vector address 


inquire about PGID CS IP 
;LHPMOUSE driver vector address. 


.EX-BIOS interrupt number. 


;Button data type. 
;16 bit relative motion data type. 


_RRARRAKKRRARARRARARRARARAARAARKARAARAARAARKRAARKRKRARARARAARKRARRRARRAAHRARARRKRKE 
, 


SUBTTL CODE SEGMENT 
PAGE 


SAR RARARRKRAAKRAAAARAR ADAH ARARARARARARARRRARARRAARARARRRRARARARRARRAAARRRAARRAR KEE 
' 

RRR RRARRARKRRAKKARAARRARRKRARRAHRARAKARARHRAARKAAARRARAKRARAKRARAARARRARRRARKHK 
t 

: CODE SEGMENT 

- RARARRARAKHAARARRARRARRARKRARAAARAAARAARARAARARAARRRARARAARARARRARAARAAKRARRAAR 
‘ 

| RARRARARARAARRARARARARARARARRARKRARARAAAAARAKRKRARRAAARKARARKRARAAARKARKRAAKRAAR 
. 


CODE SEGMENT PUBLIC ‘CODE' 


ASSUME CS:CODE, OS: NOTHING 
ORG 0 


DEV_DRIVER PROC FAR 


‘Must be org'd at 0 to be a device driver. 


RAR ARRARAARRRARRRARRRR MS-DOS DEVICE DRIVER HEADER RRARARARAKRRKRARRAKAKAR 


DD -1 
DRIVER_ATTR DW ATTR<«<1,0,0,0,0,0 
STRAT ENT DW OFFSET DEV STRAT 
INT ENT DW OFFSET DEV_INTER 
DRIVER _NAME DB ° 232MSE ' 


‘Link list entry. Must be set to -1l 


.0,0,0> :Driver attribute. 


Y 
PT 


;Device strategy entry point. 
:Device interrupt entry point. 


; MAR AKAw ARR OFX-BIOS DRIVER HEADER AND PHYSICAL DESCRIBE RECORD *"***888 


ORG 20H ;Make sure its paragraph aligned. 
DEV_ATTR EQU HP _ATTR<1,0,1,0,6,0,0,0,1,1,0,0> 
DEV_HEADER HP_HEADER<DEV_ATTR,3,0,0,0,V_LHPMOUSE ,V_DOLITTLE ,0,0> 


PS 


> 
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280 002C 0006 
281 OO2E 00 
282 OO2F O00 
283 
284 0030 02 DEV_DESCRIBE DESCRIBE <2,0,0,0,0,2,0,20H,0,0,0,0,1,0FFH,2000,0,0,0,0,0,0,0,0> 
285 0031 00 
286 0032 00 
287 0033 00 
288 0034 00 
289 0035 02 
290 0036 00 
291 0037 20 
292 0038 00 
293 0039 00 
294 003A 00 
295 0038 00 
296 003C Ol 
297 003D FF 
298 O0O03E O0C8 
299 0040 Q000 
300 0042 0000 
301 0044 0000 
302 0046 o0aod0d 
303 0048 0000 
304 004A 0000 
305 004C 9000 
306 004E 0000 
307 
308 RARAADEAREAAER AAA AREA ERAS ARR E RAEN ARATE ERA RAR A 
310 tg CODE SEGMENT RELATIVE DATA AREA * 
311 LAA ORAL AAA AA AA TARAS ERA ES EAA AAA ARERR SEERA RE RS RAR RN 
ne ater Maa tal alias ea ie DATA AREA FOR MS-DOS DRIVER PORTION RARKRAARARKRARARAAR 
314 
315 0050 9000 REQ_ HOR: OFF DW 0 ‘Storage for offset of device strategy header. 
1c 0052 0000 REQ_HDR SEG Dw 0 ‘Storage for segment of device strategy header. 
318 0054 S2 $3 2D 32 33 32 SIGN_ON MSG DB ‘'RS-232 INPUT SYSTEM MOUSE DRIVER 
319 20 49 4E S50 55 54 
320 20 53 59 53 54 45 
321 40 20 4D 4F 55 53 
322 45 20 44 52 49 56 
323 45 52 20 20 
324 0076 28 43 29 43 6F 70 DB '(C)Copyright Hewlett-Packard 1985° CR, LF 
325 79 72 69 67 68 74 
326 20 48 65 77 6C 65 
327 74 74 20 $0 61 63 
328 6B 61 72 64 20 31 
329 39 38 35 OD OA 
330 0089 56 65 72 73 69 6F VERSION _LAB DB ‘Version A.0O1.01'° CRLF, 'S’ 
331 6E 20 41 2— 30 31 
332 2E 30 31 OD OA 24 
333 » OO10 VERSION LEN EQU $-VERSION LAB-2 
334 OOAB 40 6F 75 73 65 20 OK_MSG DB ‘Mouse installed on COM' 
335 69 6E 73 74 61 6C 
336 6C 65 64 20 6F 6E 
337 20 43 4F 4D 
oe 00c1 4 3A QD OA OD OA COM_MSG DB 'O:',CR,LF,CR,LF,'S' 
340 oocs8 53 70 65 63 69 66 NO_PORT_MSG DB ‘Specified COM port not present. Oriver not installed.’ CR,LF,CR,LF, 
341 69 65 64 20 43 4F 
342 40 20 70 6F 72 74 
343 20 6€ 6F 74 20 70 
344 72 65 73 65 6E 74 
345 2E 20 20 44 72 69 
346 76 65 72 20 6E OF 
347 74 20 69 6E 73 74 
348 61 6C 6C 65 64 2E 
349 00 OA OD OA 24 
350 0103 55 6E 61 62 6C 65 NO_VECTOR DB ‘Unable to install PGID driver. ° CR LF,'S° 
351 20 74 6F 20 69 6E 
352 73 74 61 6C 6C 20 
353 50 47 49 44 20 64 
354 72 69 76 65 72 2E 
355 OD OA 24 
Hf 
0124 0000 STACK _PTR W 
a 0128 0000 STACK SEG oe : :Storage for existing stack frame. 
ac, 0128 o0000 COM NUMBER DW 0 /Offset into COM port base address table 
362 012A 0030 INT_TABLE DW OCH * 4 COM pe re Ante rrape 
363 O12c 002C Dw OBH * 4 :COM2 port interrupt. 
364 O12E 0030 DW OCH * 4 ,;COM3 port interrupt set as appropriate 
365 0130 O002C DW OBH * 4 ;COM4 port interrupt - set as appropriate. 
366 0132 FFEF MASK_TABLE DW NOT O1H SHL 4 ,;COM1 interrupt mask (IRQ4 
367 0134 FFF? Dw NOT O1H SHL 3 ‘COM2 interrupt mask (IRQ3 
soe 0136 FFEF DW NOT O1H SHL 4 .COM3 interrupt mask (IRQ4). 
a5 0138 FFF7 DW NOT O1H SHL 3 -COM4 interrupt mask (IRQ3). 
371 013A 0000 FRAME COUNT Dw 0 ‘Frame counter for mouse data packet 
are 013C os [ 56 TEMP_BUFFER OB S DUP (0) :Temporary buffer for mouse data bytes. 
374 } 
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375 
376 014! 
377 
378 0142 
379 
380 
381 
382 0150 
383 0151 
384 
385 
386 
387 0152 
388 0154 
389 0156 
390 0158 
391 O1SA 
392 015C 
393 OLSE 
394 0160 
395 0162 
396 0164 
397 0166 
398 0168 
399 O16A 
400 016C 
401 O16E 
402 0170 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 0172 
413 
414 
415 
416 0172 
417 0173 
418 0174 
419 0175 
420 0176 
421 0178 
422 
423 
424 
425 O17A 
426 017C 
427 
428 
429 
430 O17E 
431 0181 
432 0183 
433 0188 
434 
435 0188 
436 
437 
438 
439 018C 
440 0191 
441 0193 
442 0195 
443 0197 
444 0199 
445 0198 
446 0190 
447 
448 O1SF 
449 
450 O1A2 
451 O1A7 
452 O1LA8 
453 O1AD 
454 01B0 
455 0182 
456 
457 
458 
459 0185 
460 01B8 
461 018D 
462 01C2 
463 01C?7 
464 01CB 
465 0icD 
466 
467 


87 LAST_SYNCH DB 87H ;Copy of last synch byte. 
OE [ a6 HPHIL TABLE DB 14 DUP (0) ;HP-HIL configuration table. 
] 
00 HPHIL ADD DB O ;HP-HIL ‘address’ of mouse. 
00 PGID_VECT_NUM DB O ;HP_VECTOR TABLE vector address of PGID. 
; JUMP TABLE FOR MS-DOS DRIVER COMMANDS 
O2A7 R CMD_TABLE OW OFFSET INIT CODE :Initialize driver. 
O292 R DW OFFSET UNSUPPORT CMD :Media check. 
0292 R DW OFFSET UNSUPPORT CMD :Build BPB. 
0292 R DW OFFSET UNSUPPORT CMD ;IOCTL input. 
0292 R Dw OFFSET UNSUPPORT CMD ;Input. 
0292 R DW OFFSET UNSUPPORT CMD ;Non-destructive input. 
0292 R DW OFFSET UNSUPPORT CMD -Input status. 
0292 R DW OFFSET UNSUPPORT CMD :Flush input buffer. 
0292 R DW OFFSET UNSUPPORT CMD -Output. 
0292 R OW OFFSET UNSUPPORT CMD ;Output with verify. 
0292 R DW OFFSET UNSUPPORT CMD ;Output status. 
0292 R DW OFFSET UNSUPPORT CMD ;Flush output buffer. 
O292 R DW OFFSET UNSUPPORT CMD ;IOCTL output. 
0292 R DW OFFSET UNSUPPORT CMD :Open device. 
0292 R DW OFFSET UNSUPPORT CMD -Close device. 
0292 R DW OFFSET UNSUPPORT_CMD ;Removable media check. 
,RARARRARRARRAKRARA DATA AREA FOR EX-BIOS DRIVER PORTION RARARARKRARARKAAEAR 
PAGE 
ARR RRRRARRARARRARRRRARRAR RARER ARERRAAR REAR ARARARERARRRRRRARAE RARER 
Mig MOUSE DRIVER CODE * 
, RR RARAAAARARARRARRARARAAAAARAARRARARARAARARRRARRARRARARRAKKARRARRRARRAERRR 
MOUSE_INT: 
;PRESERVE MACHINE STATE 
9C PUSHF ,Save the registers. 
60 PUSHA 
1E PUSH DS 
06 PUSH ES 
8C C8 MOV AX CS ‘Re-establish data segment addressibility. 
BE D8 MOV DS ,AXx 
,; ISSUE END-OF-INTERRUPT TO 8259A 
BO 20 MOV AL, 20H -EOI 
E6 20 OUT 20H AL 
.GET CHARACTER FROM MOUSE 
B8 0040 MOV AX , 40H ‘Get base address of COM port from table. 
BE CO MOV ES AX 
2E: 8B 1E 0128 R MOV BX COM NUMBER 
26: 88 17 MOV OxX,ES: [BX] 
EC IN AL ,DX ‘Get character. 
;STORE IN TEMPORARY BUFFER UNTIL ENTIRE FRAME HAS BEEN RECEIVED 
2E: 8B 1E O13A R MOV BX FRAME COUNT :Get number of characters left in frame. 
OB DB OR BX BX :See if we're looking for synch byte. 
75 OD JNZ MSI 1 -Jump if not. 
8A EO MOV AH, AL :Save a Fig} of mouse character. 
24 F8 AND AL OF 8H ‘Mask off button bits. 
3c 80 CMP AL , 80H ‘See if this is a pyoch byte. 
8A C4 MOV AL ,AH -Get the original character back. 
74 03 JZ MSI 1 ;Put character in temporary buffer if synch 
‘byte is valid. 
E9 O260 R JMP MSI 5 ;Otherwise, throw character away. 
2E: 88 87 O13C-R MSI 1: MOV TEMP_BUFFER[BX] ,AL ‘Store character away. 
43 ~ INC BX Update the frame counter. 
2E: 89 LE O13A R MOV FRAME COUNT ,BX ‘And save it. 
83 FB O05 CMP BX ,5 ;Is this the last character in frame? 
74 «093 JZ MSI 2 -Process the frame if so, 
ES 0260 R JMP MSI § ‘Otherwise, skip on. 
;CHECK FOR A CHANGE IN BUTTON STATE 
BB 0000 MSI_2: MOV BX 0 ;New character count. 
2E° 89 1E O13A R MOV FRAME COUNT , BX ‘Store it. 
2E: 8A 87 013C R MOV AL, TEMP _BUFFER[BX} -Get synch byte. 
2E 8A 26 0141 R MOV AH LAST SYNCH ‘Get last synch byte. 
2—E A2 0141 R MOV LAST SYNCH AL Update last byte. 
3A EO CMP AH, AL ‘See if they are the same. 
74 56 JZ MSI 3 /Skip on if so (no change in button state). 


:SEND BUTTON ISR EVENT RECORD(S) TO INPUT SYSTEM 
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469 O1CF 5§3 PUSH BX ‘Save frame counter. 

470 0iDO0 52 PUSH DX :Save 

47) 0101 32 E0 XOR AH, AL ;AH now holds mask of buttons that have changed. 
472 0103 B7 Ql MOV BH OLH -Mask for first button. 

473 0105 B89 0003 MOV CX 3 ‘Number of buttons to process. 

474 

475 0108 MBUTTON: 

476 0108 8A DC MOV BL AH ;Get a copy of change mask. 

477 O1DA 22 DF ANO BL .BH ;See if selected button was the one that changed. 
478 010C 74 41 JZ MNEXT_ BUTTON ‘Skip on if not. 

479 OLDE 84 F8 TEST BH AL ‘Determine state (make or break) of selected butt 
480 O1EQ 74 04 JZ MBUTTON DOWN 

481 

tea O1E2 MBUTTON_UP. 

48 

484 O1E2 B3 80 MOV BL , 80H ;Set bit 7 (make/break bit) to O (break). 
ne O1E4 EB 02 JMP SHORT MBUTTON_ISR 

48 

re O1E6 MBUTTON_DOWN. 

48 

ace O1E6 B3 OO MOV BL ,OOH ‘Set bit 7 (make/break bit} to 1 (make). 
49 

491 O1E8 MBUTTON_ISR.: 

492 O1E8 §3 PUSH BX 

493 O1E9 $8&B DS MOV BX, CX 

494 O1E8 32 FF XOR BH, BH 

495 O1ED FE CB DEC BL 

496 OlEF 2E: 8A 8F OIF7 R MOV CL, CS:BUTTON TAB[BX} 

497 OlF4 58 POP BX 

498 O1F5S €B 03 JMP SHORT BISR2 

499 Ol1F7 0 BUTTON TAB 08 0 » left button 

500 O1F8 O62 08 2 > middle button 

501 OL1F9 O21 DB 1 ; right button 

502 O1FA BISR2: 

503 O1FA OA DY OR BL, CL 

ae Ol1FC 32 FF XOR BH, BH - clear out bh 

506 O1FE 50 PUSH AX ;Save registers. 

507 O1FF 53 PUSH BX 

508 0200 51 PUSH Cx 

509 0201 I1€ PUSH DS 

510 

$11 pare 

ae ‘Create ISP Event Record 

§14 0202 B6 O09 MOV DH, T _KC_BUTTON ;Set data type 

515 0204 2E: 8A 16 0151 R MOV DL, PGID_VECT_NUM ‘Get vector number of mouse's PGID. 
516 0209 69 0000 MOV cx 0 “Burst length (N/A). 

517 020C 8c C8 MOV AX cS ‘Point ES:0 to driver header. 

518 O20E€ 40 INC AX 

§19 O20F 40 INC AX 

§20 0210 8E& CO MOV ES ,AX 

521 0212 B4 00 MOV AH,F_ISR ‘Set ISR function. 

§22 0214 B80 O02A MOV BP ,.V_SINPUT ‘We're calling the INPUT driver. 

$23 O217 FA CLI ‘Turn off interrupts while we're out. 
524 0218 CD 6F INT HP_ENTRY 

a5. O21A FB STI ;Re-enable interrupts. 

§27 021B IF POP DS 

§28 021C 593 POP CX 

529 0210 58 POP BX 

BE Q21E 58 POP AX 

ae O21F MNEXT BUTTON: 

534 O21F DO E7 SHL BH 1 ‘Move button selector mask to next button. 
§35 0221 E2 BS LOOP MBUTTON 

536 0223 SA POP DX ;Restore 

Pee 0224 $8 POP Bx ‘Get frame counter back. 

zap “CHECK FOR MOTION 

541 0225 43 MST 3: INC BX ;Point to firet delta X in buffer. 
542 0226 2E: 8A 97 O13C R MOV DL, TEMP_BUFFER[BX) 

543 O22B 43 INC Bx “Get first delta Y. 

544 O022C 2E: 8A B7 O013C R MOV DH. TEMP BUFFER[BX] 

545 0231 43 INC BX ;Add second delta X to first. 

546 0232 2E: 02 97 O13C R ADD OL, TEMP _BUFFER(BX) 

$47 0237 43 INC BX ,Add second delta Y to first. 

pe 0238 2E: O02 B7 O13C R ADD DH, TEMP _BUFFER(BX] 

550 0230 OB D2 MST_4: OR OX DX ;Check for zero motion. 

oes O23F 74 IF JZ mst 5 ‘Skip on if none detected. 

§53 pare 

2ee ;SEND MOTION ISR EVENT RECORD TO INPUT SYSTEM 

556 0241 BA C2 MOV AL OL ;Convert delta X to 16 bit valua and put 
557 0243 98 CBW :it in ISR Event Record (8X register). 
558 0244 8&8 D8 MOV Bx AX 

559 0246 8A C& MOV AL ,DH ,Ditto for delta Y (CX register). 

560 0248 98 CBW 

561 0249 8B C8 MOV Cx AX 
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562 

563 

564 0248 B66 41 

565 

566 O24D 2E: 8A 16 0151 R 
567 0252 8C CB 

568 0254 40 

569 0255 8& CO 
570 0257 B4 OO 

571 0259 BD 002A 
572 O25C FA 

573 0250 CD 6F 

574 O2SF FB 

575 

576 

577 

578 0260 07 

579 O261 IF 

580 O262 61 

581 0263 9D 

582 0264 CF 

583 

584 

585 

586 

587 

588 

589 

590 

531 

592 0265 

$93 0265 2E. 89 1E QO50 R 
$94 O26A 2E: 8C 06 O0OS2 R 
595 O26F CB 

596 0270 

597 

598 

599 

600 0270 

601 

602 

603 0270 9C 

604 O271 FC 

EOS 0272 60 

606 0273 8C CF 

607 0275 8€& DF 

68 

609 

610 O277 2E: C4 3E 0050 R 
611 027C 26: 8A 45 02 
612 0280 3C 00 

613 0282 72 OE 

614 0284 3C OF 

615 0286 77 OA 

616 0288 98 

617 0289 O01 EO 

618 G28B 8B D8 

€19 O028D 2E: FF A7 0152 R 
629 

621 

622 

623 0292 

624 0292 

625 

626 0292 26: 81 4D 03 8000 
627 0298 26: 81 4D 03 0003 
628 

629 

630 

631 O29E 26. 81 40 03 0100 
632 O2A4 61 

633 O2A5 90 

634 O2A6 CB 

635 

636 

R37 

638 

639 

640 

641 O2A7 

642 

643 

644 O2A7 FA 

645 

6 46 C2A8 BE 0124 R 
647 O2AB 89 24 

648 O2AD 83 C6 O02 
649 O2BO 8C 14 

€50 

651 C2682 BC O511 R 
652 0285 8C C8 

653 O2B7 8£€ DO 

654 

£S5 0269 FB 
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;Create motion ISR event record 
MOV OH, T_REL16 ;Set ISR Event record data type to 16 bit 


;relative motion. 


MOV DL,PGID_VECT_NUM ;Get vector number of mouse'’s PGID. 
MOV AX,CS ;Set ES:0 to driver header. 
INC AX 
MOV ES AX 
MOV AH,F_ISR :Select ISR function. 
MOV BP, V_SINPUT We're passing this on to the INPUT driver. 
CLI :Interrupts are supposed to be off. 
INT HP_ENTRY 
STI ;Turn interrupts back on now. 
;RESTORE MACHINE STATE AND EXIT 
MSI_S: POP ES 
POP DS 
POPA 
POPF 
IRET 
PAGE 
SEAR AA ARR RA RE RR ERR 
ial MS-DOS DRIVER CODE n 


OPPS PPO Creree err re rer ee re tis relia crete rr ree terre rere eee 
MA ERASER AER OR ER STRATEGY ENTRY POINT BRAKRKRAARKRAKRARKRKRARAAAKRKREA 


DEV_STRATEGY PROC FAR 
MOV CS:REQ HOR OFF , BX 
MOV CS:REQ_HOR_SEG,ES 
DEV_STRATEGY ENOP 
_ RR RARARRARRRARRARRRAARR INTERRUPT ENTRY POINT RARRARRKRRARKRAARAAARARARRARR 
DEV_INTERRUPT PROC FAR 


, SAVE mar ties STATE 
H 


;Save offset of request header. 
;Save segment of request header. 
-Return to MS-DOS. 


PUS 
CLO 
PUSHA ;Save registers. 
MOV DI,CcSs ;Set DS to CS. 
MOV DS DI 
;FETCH COMMAND FROM REQUEST HEADER 
LES DI,DWORD PTR REQ HOR OFF ;,Move address of request header into ES:DI. 
MOV ere tO TT MECH CODE Get command byte from header. 
CMP AL,MSD_INIT :Perform range check on command byte. 
JB BAD CMO 
CMP AL,MSD_REM MEDIA 
JA BAD_CMO 
CBW ;Convert command into jump table offset. 
SHL AX ,1 
MOV BX , AX 
JMP CMO_TABLE[BX] ‘Dispatch to requested function. 


-EXIT POINT FOR BAD OR UNSUPPORTED FUNCTIONS 
BAD CMD: 
UNSUPPORT_CMD: 
OR FS. bt .RH_ STATUS, MASK ERROR ;Set error flag in return status word. 


OR ES .RH_STATUS, MSD_UNKNOWN CMD ;:Set error code. 
;COMMON EXIT POINT 
EXIT: OR ES:[O0I).RH STATUS, MASK DONE ;Set return status to done. 
POPA ;Restore registers. 
POPF ‘Restore flags. 
RET ‘Return to Me-Dos. 


AR ARRARRRARARARRRERRRRR END OF RESIDENT CODE RARAKRKARKRARARAARARAARKRRARAARR 


PAGE 


AAR RRA RR RR EAS INITIALIZATION CODE RAARRARKRAAAARARARARARARRRAR 


INIT _CODE - 


.SET UP LOCAL STACK 
CLI ‘Disable interrupts while we're messing with stack. 


MOV SI OFFSET STACK _PTR ‘Store existing stack environment. 
MOV {St yct 

ADD I 

MOV (st).ss 

MOV SP OFFSET CS:STACK_TOP ;Set up our local stack. 

MOV AX ,CS ‘Stack segment is same as code (CS). 
MOV SS ,AX 

STI ;Re-enable interrupts. 
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au ;PRINT SIGN-ON MESSAGE 

659 O2BA BA O0S4 R MOV DX OFFSET SIGN _ON MSG 

660 028D B4 O9 MOV AH, PRINT STR 

ee O2BF CD 21 INT DOS_ENTRY 

66 

663 »PARSE CONFIG.SYS COMMAND LINE TO DETERMINE WHICH COM PORT THE MOUSE IS ON 
664 

665 C2C1 BB 0000 MOV Bx ,0 ‘Clear BX. It will be used as index into 

666 :command line. 
ae 02C4 26 C4 7D 12 LES OY,ES: (DI) .RH_CMO_LINE eae ES:DI with pointer to CONFIG.SYS command 

;bine. 

669 
670 02C8 26: 8A O01 IC_1: MOV AL BYTE PTR ES: (DI+BX] ;Get next character in command line. 

671 O02CB 3C 2F CMP AL,'/' ‘Check for backslash. 
672 02CD 74 OB JZ IC 2 .If found, indicates start of parameters. 
673 O2CF 3C OD CMP AL,CR ‘Check for carriage return. (Indicates a bogas 
674 ;set of parameters). 
675 02D1 74 1C JZ IC_3 :If found, stop cue ty command line. 
676 0203 3C OA CMP AL ,LF ;Check for line feed. (Indicates no parametors 
677 ;entered in command line. 
678 0205 74 18 JZ Ic 3 .If found, stop scanning command line. 
679 0207 43 INC BX -Else, point to next character, 
Pe 0208 EB EE JMP Ici ;and continue scanning command line. 

81 
682 O2DA 43 IC_2: INC BX ‘Get next character. Should indicate COM port 
683 O020B 26: 8A Ol MOV AL BYTE PTR ES: (DI+BX] ;to use. Valid range is 1 - 4. 
684 O2DE 2C 31 SUB AL, ‘1° ;Convert number into offset from 1. 
685 O2EO0 72 OD JB Ic 3 :Perform range check on results. 
686 O2E2 3C 03 CMP AL 3 
687 O2E4 77 O9 JA IC_3 
688 O2E6 98 CBW ‘Convert into offset into STO-BIOS COM port 
689 ;base address table at 0040:0000H. 
690 O2E7 O01 £0 SHL AX,1 
691 O2E9 2E: AZ 0128 R MOV COM NUMBER , AX ‘Save it for future use. 
692 O2—ED EB 07 JMP SHORT IC 4 

693 = 

694 O2EF 2E: C7 06 0128 R QOO0OD 1C_3: MOV COM_NUMBER ,0 -If we wind up here, there were no parameters 
695 ‘soecified in the command line, or an invalid 
696 “COM port was specified. Set COM port COM1 
697 .default. 

698 

699 O2F6 8B D8 Ic_4: MOV BX ,AX ‘Convert offset into ASCII COM number (1 - 4). 
700 O2F8 O1 EB SHR BX, 1 

701 O2FA 80 31 ADD BL,‘1' 

702 O2FD 2E: 88 1E OOC1 R MOV COM_MSG,BL ;Store in sign-on Wade bg 

703 0302 FA CLI ‘Disable interrupts while mouse interrupt 

704 ,ils being set up. 

705 

706 ‘INITIALIZE SERIAL PORT PARAMETERS 

707 

708 0303 8B F8 MOV OI ,AX ;Move COM port table offset into OI. 

709 0305 B8 0040 MOV AX, 40H ;Segment address of COM port base address table. 
710 0308 8E CO MOV ES AX 

711 O30A 26: 8B 15 MOV DX ,ES: [DI] ;Get base address of COM port out of table. 
712 0300 OB D2 OR DX ,DX ;Make sure port exists. 

713 O30F 75 03 JINZ Ic _ 4A ;Continue with initialization if it does, 

714 0311 E9 O3B2 R JMP INTT_NO_PORT ,otherwise, go to error routine. 

715 

716 -Clear existing error or character. 

717 

718 0314 83 C2 05 IC_4A: ADD DX,5 

719 0317 EC IN AL ,DX 

720 0318 EB 00 JMP SHORT $+2 

721 

ie ;Set baud rate divisor to 1200 baud. 

724 O31A 83 EA 02 SUB DX ,2 ;Point to Line control register. 

7258 031D BO 80 MOV AL, 80H ;Set line control register to divisor programming 
726 O31F E€ OUT DX AL mode. 

727 0320 £B OO JMP SHORT $42 Delay. 

728 0322 83 EA 03 SUB OX ,3 :Point to divisor LSB register (base). 

7293 0325 BO 60 MOV AL ,60H ;LSB for 1200 bps. 

730 0327 EE OUT DX ,AL 

731 0328 EB OO JMP SHORT $+2 peray 

732 032A 42 INC Ox ;Point to MSB of divisor (base + 1). 

733 0328 B80 00 MOV AL ,OOH :MSB for 1200 bps. 

734 032D EE OUT OX,AL 

a 032E EB O00 JMP SHORT $+2 ;Delay. 

aes ;Initialize line control register. 

739 0330 83 C2 02 ADD DX ,2 ;Point to line control register are +3). 
740 0333 BO 03 MOV AL ,03H ;8 data bits, 1 stop bit, no parity. 

741 0335 EE OUT DX AL 

ae 0336 E8 00 JMP SHORT $+2 Delay. 

4 

tas ;Initialize modem control register. 

746 0338 42 INC DX ;Point to modem control register (base + 4) 
747 0339 BO OB MOV AL ,O8H ;DOTR and RTS set, OUT2 set to enable interrupts. 
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0338 
033C 


O33E 
0341 
0343 


EE 
EB 
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:Delay. 


‘Point to interrupt enable register 


(base + 1) 


‘Enable Rx Data Ready interrupt 


‘Get 


table offset back. 


‘Use it as index into interrupt vector table. 
‘Set ES to interrupt vector segment (0:). 


‘Initialize vector. 


‘Gat mask from table. 


‘Get current mask. 
,Delay. 


:Clear mask for mouse interrupt. 


-Set new value. 


‘Re-enable interrupts. 


Return CS:.IP of PGID driver function. 


;See if brute force approach is necessary. 


‘Even the best laid plans of mice and men aft 


;go awry. 
“some early 


Ons. 


F INQUIRE PGID is not implemented in 
ROM versi 


The PGID CS:IP must be 


shard coded for these syatems. 


‘Move IP into OL. 
‘Get PGIC's DOS. 
-account for ORG 20H 


;Exchange fixed vector address function. 


‘Is it installed in vector table 


/Set up for the divide 


vector 
Events 


Convert to a 


‘Save for ISR 


Now to make 
driver sets 


‘Print error message. 


‘Print error message. 


index 


sure that the V_LHPMOUSE 
up INT 33H. 


:Set DS back to proper value. 


:Print sign-on message. 
.MS-DOS print string function number. 


now to set the number of buttons 


OUT DX AL 
00 JMP SHORT $+2 
‘Initialize interrupt enable register. 
FA 03 SUB DX ,3 
MOV AL.O1 
OUT DX, AL 
-SET UP COM PORT INTERRUPT VECTOR 
8B 1E 0128 R MOV BX ,COM NUMBER 
8B BF 012A R MOV DI. INT_TABLE (BX) 
0000 MOV AX.0 
0 MOV ES |AX 
0172 R MOV AX |OFFSET MOUSE_INT 
STOSW 
C8 MOV AX,CS 
STOSW 
-ENABLE MOUSE INTERRUPT ON 8259A INTERRUPT CONTROLLER 
8B 8F 0132 R MOV CxX,MASK_TABLE[BX] 
1 IN AL 2 
0 JMP SHORT IC_10 
1 IC_10: AND AL, CL 
1 OUT 21H, AL 
STI 
C MOV AH, F_INQUIRE_ENTRY 
002A MOV BP | V~SINPUT 
PUSH OS 
6F INT HP_ENTRY 
POP dS 
FC 02 CMP AH RS_UNSUPPORTED 
06 JNE INIT 3 
PUSH CS 
POP ES 
LE O3FF R LEA BX, CS:PGID_ORIVER 
FB INIT 3: MOV DI, BX 
CA MOV DX.CS 
C2 02 ADD DX. 2 
OA MOV AH|F INS XCHGFREE 
0012 MOV BP | V_SYSTEM 
PUSH DS 
6F INT HP_ENTRY 
POP DS 
FC F6 CMP AH, RS_NO_ VECTOR 
18 JE INIT _NO_VECTOR 
C3 MOV AX, BX 
06 MOV BL. 6 
F3 DIV BL 
A2 O1S1 R MOV PGID_VECT_NUM, AL 
04 MOV AH, F_IO CONTROL 
02 MOV AL, SF MOUSE OVERRIDE 
oocc MOV BP’ V_CHPMOUSE 
PUSH 0S 
6F INT HP_ENTRY 
POP DS 
13 90 JMP INIT _OK 
INIT _NO VECTOR: 
0103 R MOV OX OFFSET NO VECTOR 
09 MOV AH PRINT STR 
21 INT DOS ENTRY 
14 JMP SHORT INIT EXIT 
INIT_NO_PORT: 
O0C8 R MOV DX OFFSET NO PORT MSG 
09 MOV AH PRINT STR 
21 INT DOS ENTRY 
08 JMP SHORT INIT EXIT 
INIT_OK: 
C8 MOV AX CS 
D8 MOV DS AX 
OOAB R MOV OX OFFSET OK _MSG 
09 MOV AH PRINT STR 
21 INT DOS_ENTRY 
INIT_EXIT: 
PUSH ES 
PUSH AX 
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841 03C8 88 0000 
842 O3CB 8E CO 

843 O3CD 26: 8E O06 O1BE 
844 0302 26: 8— 06 O00D0 
845 O03D7 26: C6 06 O04C 03 
846 O3DD 58 

847 O3DE 07 

848 

849 O30F 2E: C4 3E& 0050 R 
850 O3E4 26: C7 45 O& O4D1 R 
851 O3EA 26: 8C 40 10 
852 

853 

854 

855 O3EE FA 

856 OSEF BE 0124 R 
857 O3F2 8B 24 

858 O3F4 83 C6 02 
859 O3F7 8B 04 

860 O3F9 8E DO 

861 O3FB FB 

862 

863 O3FC ES O29E R 
864 

865 O3FF 

866 O3FF 

867 

868 

869 

870 

871 

872 

873 

874 

875 

876 

877 

878 

879 

880 

881 

882 

883 

884 

885 

886 

887 

888 

889 

890 

891 

892 

893 

894 

895 

896 

897 

898 

899 

900 

901 

902 

903 

904 

905 O3FF 

906 O3FF 80 FC 00 
907 0402 75 04 

908 0404 £8 0414 R 
909 0407 CF 

910 

911 0408 

912 0408 80 FC 02 
913 O40B 75 04 

914 040D E8 0496 R 
915 0410 CF 

916 

917 

918 

919 

920 

921 

922 0411 

923 O411 B4 02 

924 0413 CF 

925 

926 0414 

927 

928 

929 

930 

931 

932 


MOV Ax, 0 
MOV ES, AX 
MOV ES, ES: [HP_ENTRY * 4 + 2) 
MOV ES, ES:{V eee ane 
oe BYTE PTR ES:MSE_NUM_BUTTON,3  :Define the number of buttons to 3 
POP ES 
LES DI,DWORD PTR REQ HOR OFF -;Reload ES:DI with address of request header. 
MOV sae .RH_END_OFF OFFSET END_OF DRIVER :Return end of resident code to 
MOV ES:{D0I}].RH_END SEG,CS >MS-DOS. 
;RESTORE OLD STACK FRAME AND EXIT 
CLI ‘Disable interrupts while working on stack frame 
MOV SI,OFFSET STACK PTR Get address of old stack storage. 
MOV SP, (ST) ‘Restore stack pointer. 
ADD SI ,2 ‘Get old stack segment 
MOV AX. [SI And 
ey eels ] nd restore it. 
STI ;Re-enable interrupts. 
JMP EXIT 
DEV_INTERRUPT ENDP 
DEV_DRIVER ENDP 
page 


- wa aQDRIVER HEADERewneccunveve webbnewedssGsasse ecNanswebeeee sbacecaacns 
NAME: PGID DRIVER 
; DESCRIPTION: 


‘ LIST OF FUNCTIONS: (function code in hex} 

; (Those functions not listed are NOT SUPPORTED. } 
F_ISR 

F_SYSTEM 

- PARAMETERS: 


; See function headers for specific values for other entry and exit 
‘ parameters 


: REGISTERS PRESERVED: 

: DEFINITION MODIFICATION HISTORY 

VERSION: 

DESCRIPTION OF CHANGES: 

ule odes enon aunine Cae wueb hed sowaee occendueeincaadaseveciaseidecitouielcaacs 


subttl] PGID Main entry point 


page 
assume cs:CODE, ds:nothing 
public PGID ORIVER 


; NOTE "*** No driver header for PGID *#*8 
; Only 2 functions are supported: F_ISR, F_SYSTEM -- all others are unsupported 


pgid_ driver proc near 
cmp ah, F ISR ; F_ISR? 
jne check f_system 
call pgid_Isr 
1ret 
check _f system: 
cmp ah,F SYSTEM ; F_SYSTEM? 
jne pgid_ opcode bad 
call pgid_ system 
iret function has set return code 


[mem wa ener wnw err ener nen ww enw enw ene wee en ewww wen ww wren we eee ew on ewe wee wwe ow 


> Main opcode out of range of PGID functions supported 
; just return RS UNSUPPORTED 


pgid opcode bad: 


pgid driver endp 


peas 

;@aeaeFUNCTION HEADE SSSRSSSSAKRSSSSSSTSSSESESSRHREDTRSRSSE ABBE R eRe 
NAME: PGID_ISR 
FUNCTIONAL DESCRIPTION: 
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0414 


0414 
0417 


DOWOWOWOWOUOOOOWOWWOWWoO 
DO WO WO W 00 & 09 0 OO OW OH O&O AI 
WMI OW CONDOR WN OW C~ 


0419 
994 0419 
995 O4iC 
996 O4l1e£ 
997 0421 
998 0423 
999 0426 
1000 0428 
1001 0428 


1006 042D 
1007 O42F 


0430 
0430 
0434 
0438 
043A 


NS WM OM ON MU & WA 


bb pe be bo be eb ee 
oo0ogooococoo0co0o0co0000 
RO ABD A PO DAD b= = bm 
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B4 
C3 


co TIN) oO 
onwOomn 


ono NWO™MNON 
wmMomommm 


FE 


—_— OK 
momm 


09 


40 
41 
42 
43 


A graphics input device (GID) physical event has occurred which 
caused an Prise request. If the event was a button press, then 

, the D_STATE and D_TRANSITION fields will be adjusted and the parent 

, driver will be called immediately. 

: If a the event was a movement, this function will update the 
absolute position field if the device is a relative device or will 
update the relative position field if it's an absolute device. It 

- will then call the PARENT driver to handle the movement event. 

RR Se RARAARARARARARARARAARKRRARARARARARKARR 

; NOTE: T PGID driver takes HP-HIL ‘Y' axis data and translates 

: it into INDUSTRY-STANDARD space data (flips the Y axis). 

: HP-HIL has positive ‘Y' in the upward direction, while 

INDUSTRY-STD. is downward. 
a an 


' 
-_ RRRRRRAR RAARARARARRARRARARKRARARKRARA 
‘ 


PARAMETERS 


; ON ENTRY: 
: AH = F_ISR 
: DH = D TYPE 
: DL = SOURCE Vector Index 
: DS:0 = Pointer to Physical device header and describe record 
. For Button Event (Keycode Event Record) : (D_TYPE = T_KC_ BUTTON) 
: BX =» Button transition information 

bits 0..6: buttons 

bits 7: QO up transition 

1 down transition 
For Movement Event (GID Event Record, D_TYPE = T RELO8, T_RELI6, 

; T ABSO8, or T Bese 
; BX = AXIS-O (X) Movement in RAW data form (SIGN EXTENDED, if necessary 
; CX = AXIS-1 (Y) Movement in RAW data form (SIGN EXTENDED, if necessary 


; ON EXIT: 
: AH = Return Code (SET BY PARENT Driver) 


REGISTERS ALTERED: ax,bx,cx 
DEFINITION MODIFICATION HISTORY 
VERSION: 
DESCRIPTION OF CHANGES: 


’ 
, SSSR SSSSSSSSTESSSSHASHSSSTSSSHSSSHSSTASASSHESRASSSSSESsesenasssseesaessssasacs 


pgid_isr proc near 


[mem enw wm were wnwr ere ene newer eee wee we ew ww 


cmp dh,T_KC_ BUTTON ; D_TYPE =» T KC BUTTON ? 
je short button isr ; adjust D_STATE & D_TRANSITION 


A movement occurred. If this was an absolute device 
that moved, then adjust the relative location field in the describe record. 
If it was a relative device, then adjust the absolute location field 
in the describe record. 
BX.CX have X,Y movement respectively. 


cmp dh,T RELO8 ; relative 8 bit movement 

je short rel move 

cmp dh,T_RELI6 ; relative 16 bit movement 
je short rel move 

cmp dh,T_ ABSOS ; absolute 8 bit movement 

je short abs move 

cmp dh,T_ ABS16 ; absolute 16 bit movement 
je short abs move 


wr rw ew ene wwe wwe ee ewww eww een ew ewe wee ewe wee enw eww 


mm emer erwwtwre ewe nwo nwn ere ere wenwn ener ew enw e ewe ew ween wan 


mov ah, RS FAIL > return RS FAIL 
ret ; return to main driver 
page 


, SSRSSRSSERRTEUEETTR ESSER SeTSS 

: Absolute movement 

We must invert the Y axis to put into INDUSTRY STANDARD coordinate space. 

; Must convert ‘Y' coordinate such that negative movement is upward (opposite 
: of HP-HIL definition. ) 

; 7° Set BX,CX (x,y ABSOLUTE movement) for event record when done, then pass 
: event record to parent driver. 


(BX) is ‘X’ HP-HIL coordinate. 
; (CX) is ‘Y¥' { ABS Y({std) = O_SIZE_Y 
, BSRBSSSTCHESSESEREERRRRSSESETS 
abs move: 


ABS_Y(hphil) ] 


xchg bx,ds:D0_ABS X save new x position 


sub bx,ds:D_ABS_X : (OLD - NEW) 
neg bx ; Relative move = {NEW - OLD) 
mov ds:D_REL_X,bx ; Save new x relative 
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1026 

1027 O43— 8B 1E 0012 
1028 0442 2B D9 

1029 0444 87 1€ 0016 
1030 0448 2B 1€ 0016 
1031 044C F7 OB 

1032 O44E 89 OE 0018 
1033 

1034 

1035 

1036 

1037 0452 8B 1E— 0014 
1038 0456 8B OE 0016 
1039 O45A EB 31 

1040 

1041 

1042 

1043 

1044 

1045 

1048 

1047 

1048 

1049 

1050 

1051 

1052 

1053 045C 

1054 O45C, 89 1E 0018 
1055 0460 F7 D9 

1056 0462 89 O£ OO1A 
1057 

1058 0466 O1 1E€ 0014 
1059 O46A Oi OF 0016 
1060 

1061 

1062 

1063 

1064 O46E EB 1D 

1065 

1066 

1067 

1068 

1069 

1070 

1071 

1072 

1073 

1074 

1075 

1076 

1077 

1078 = 0080 

1079 

1080 0470 

1081 

1082 

1083 

1084 

1085 0470 8A CB 

1086 0472 80 El 7F 
1087 0475 BO Ol 

1088 0477 D2 ED 

1089 

1090 0479 A2 O00C 
1091 

1092 047C F6 C3 80 
1093 O47F 74 06 

1094 0481 

1095 0481 08 06 O00D 
1096 0485 EB 06 

1097 0487 

1098 0487 F6 DO 

1099 0489 20 06 O000D 
1100 

1101 

1102 

1103 

1104 

1105 

1106 

1107 

1108 

1109 

1110 048D 

dill 048D B4 OO 

1112 O48F 8B 2E OOOA 
1113 0493 CD 6F 

1114 0495 C3 

1115 0496 

1116 

1117 


mov bx,ds:O_ SIZE Y ; ‘Y' limit 

sub DK ,CX ; invert the axis: bx © (LIMIT - y) 
xchg bx,ds:D_ ABS Y ; New ABS Y 

sub bx,ds:D_ ABS Y ; (OLD - NEW) 

neg bx ; Relative move = jE - OLD) 

mov ds:D_ REL X,cx ; save new Y relative 


record 


[meen ew erwrerwrnwraeevwnwrwn eee eee ewer ecewennw eee een eer eewewen oe 


mov bx,ds:0 ABS X 

mov cx,ds:D ABS Y 

jmp short give To _parent ok to pass event to parent 
page 


, PSSSSTSRESTRSESRSRSTSRSESSSESE 


; Relative movement 


; We must invert the Y axis to put into INDUSTRY STANDARD coordinate space. 


; Must convert ‘Y' coordinate such that negative movement is upward (opposite 
: of HP-HIL definition. ) 

> ~> Set BX,CX (x,y RELATIVE meverent) for event record when done, then pass 
; event record to parent driver. 


. (ex is 'X' HP-HIL coordinate 


is ‘Y' [ REL_Y(std) = -REL_Y(hphil) ] 
‘RS ERBRSEBSERTBPSBERBSRBSBRSSRBERRBBBBRBRBEee 
rel move: 
mov ds:D_REL X,bx save new rel. move (X 
neg cx CONVERT TO INDUSTRY STO. SPACE 
mov ds:D_REL_Y,cx gave new rel. move (Y) 
add ds:D_ABS X,bx ; add new X relative movement 
add ds:D_ABS_Y,cx ; add new Y relative movement 
 BX.CX still contain X,Y relative movement information for the event record 


ee wm nee wen eee ene w2rnnner een wwreneezee2eecewn wn ezeezeenwznnwezeeerannwrwroere 


short give_to_ parent ; ok to pass event to parent 


i ere 


Button Press/Release ISR 


Adjust the D_TRANSITION and D_STATE fields of the physical device's 
describe record. 


Assuming: 1. Only one button can make a transition at a time. 
2 The button eae either goes up or down, not both. 
u 


3. No strings of ttons are sent (CX register available). 
BL is number of button that changed 
bit 7 is the up/down (1/0) flag 
UP_DOWN BIT equ 10000000B bit 7 is up (1), down(0) bit 


mmr www www wm m ewe meee enw e ewe we ew ew ewe ewe we wee w= 


Convert button number to 
; to the changed button 


ewaewreewnere een ww ene nnn wow en ween enw en ewe een en wwe ee 


mov cl,o1 : pee button # keycode in CL for shift 
and c1,011111118 ; keep button #, get rid of up/down flag 
mov al ,000000018B put ‘Ll’ in bit of al 

shi al,cl ; get appropriate button bit mask 

mov ds:D_TRANSITION, al ; note which button changed 


test b1l,UP_DOWN BIT [bit 7) Was it UP = 1 or down = 0 
jz short button _down 
button_up: 
or ds:0 STATE,al ; set the button = 1 (up) 
jmp short give _to_ parent ; ok to pass event to parent 
button_down: 
nat al invert for clearing the bit 
and ds:D STATE,al clear the button to 0 (down) 
; fall through to GIVE TO_PARENT code -- ok to pass event to parent now 
: jmp give to_parent ; (COMMENTED OUT -- jump not necessary) 
page 


ok to pass event to parent now 


me ewe ew ewe ew eee we ew wee ewe wer www ewww ener e swe nee 


Call PARENT driver to handle the ISR 
NOTE: HPHIL driver has already adjusted O SOURCE field, HPHIL_ID and other 
relevant HPHIL info before passing the event up to here. 


ww enw ewww eee eee ewww eww ww eww ewww ew ew ww ew we ww wee 


mov ah,F_ISR tell parent: ISR function 

mov bp,.ds:DH V_PARENT parent's vector 

INT HP_ENTRY 

ret return to main driver 
pgid_isr endp 

subttl PGIO_SYSTEM function 
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0496 

0496 3C 06 90 30 
049A 77 OD 

049C 87 EB 

O49E 8A D8 

O4A0 32 FF 

O4A2 87 EB 

O4A4 2E: FF A6 O4AC R 
04A9 

O4A9 B4 02 

O4AB C3 

O4AC 

O4AC 0484 R 

O4AE O4BC R 

0480 O4BF R 

0482 O4C2 R 

= 0008 

04B4 


DODO DODO OOOO OW OO © O © © © © & & OO © OD 009 C0 OD 00 09 IE SEE OOOO MOADMOMAUWNIUNUTUT UU UNUTUIU & & & & & & & & & & WW WW 0) 0) WA APD RD DOPOD ARD AD PDA Oe 
ODOARMMW AWN HOW ONODUN WN OO COON MUR WAH OO OND UWA OO ONO Um UIN OO COND CHUA OO COO NOU AWA O OO COON RUMRWN HS OD ONOUAWN OO CO 
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eRe 
-esaFUNCTION HEADE BSSSRSSSSSSSSSSSSSRTSSTARSSESSATTETHUTS Esse eneseeess 


NAME: PGID_ SYSTEM 
FUNCTIONAL DESCRIPTION: 

This function supports the HP SYSTEM subfunctions requested of 
the PGIO driver. The subfunction is checked to make sure that it 
is in the appropriate range. 

PARAMETERS 
ON ENTRY: 
AH « F SYSTEM 
AL = SYSTEM subfunction code 


F_ SYSTEM Subfunctions (in hex): 
ens eas not included are UNSUPPORTED) 
N 


SF_START 

SF _ REPORT STATE 

SF_VERSION DESC 

ON EXIT: 

: See individual system subfunctions for values returned. 

: RS _ UNSUPPORTED will be returned if the subfunction is out of range. 
REGISTERS PRESERVED: 

- DEFINITION MODIFICATION HISTORY 

VERSION: 

DESCRIPTION OF CHANGES: 


' 
, SRRESSSHESSHSSHESTASTCSSSSHSSHKSESSTSSHCERSTS SHEE Sess seseseaseseeseeesaesaacenes 
- 


page 
pgid_system proc near 
cmp al MAX PGID_SYS_FN ; check bounds 
ja short pgid sys _bad , out of range ? 
xehg bp, bx ; save bx, set bpesubfunction code (al) 
mov bl,al 
xor bh,bh 
xchg bp ,bx 
jmp cs:word ptr pgid_sys_case(bp] 
pgid_sys_bad: 
mov ah,RS_ UNSUPPORTED ; bad subfunction code 
ret ' return to main driver 


pgid sys case: 


dw word ptr pgid_ init . SF_INIT 

dw word ptr pgid_start ; SF_ START 

dw word ptr pgid state ; SF_REPORT_ STATE 

dw word ptr paid cvertion - SF_VERSION DESC 
MAX PGID_ SYS FN equ byte ptr ($3 - pgid_sys_case - 2) ; max supported sys fn. 
pgid_system endp 


subttl PGID_INIT System Subfunction 
age 
;seeFUNCTION HEADER ceaducweceseswewlcnawesacuscuceeucttesecseeeeeuaten 
NAME : PGID_INIT 
FUNCTIONAL DESCRIPTION: 
System subfunction SF_INIT -- initialize the a A ae device 
header and describe record. IT IS ASSUMED THAT TH PHIL DRIVER HAS 
> INITIALIZED ALL APPROPRIATE INFO ALREADY... All position and button 
; data is zeroed out, and relevant HPHIL info is already filled in. 
> Only must set default button states (all off (#1)). 
PARAMETERS 
ON ENTRY: 
: AH # F SYSTEM 
: AL »® SF_INIT 


ON EXIT: 
AH = Return status (RS SUCCESSFUL) 


REGISTERS ALTERED: ax 
DEFINITION MODIFICATION HISTORY 
VERSION: 


a 


UU UN UR UF UF OF UT UT U1 ge ge Se Be fe Be & & & & WW LW WG) GIG) 9 WP PON NINA BOD be be be ee ee be 


URW OD DONODUAWNHOOR YOUR WN HOO ON OUTRUN HOW DNODU RUN OD ONAUE WNFOWONAU WAH WW 


Dae te ee bee bee pee ame ee Pe Pet ee poe fee bee ee fee eae eee ee Ps Oe ee 
fae pee pees pes pre fre fee fran pee bee ee bet be eee ee eee fet feet ee es pee een ee fem be ee de ae ae ee be ne ne ee be ee be be bee ee ee be ee bee be be be bm be Pe be ee be De bs be et 
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PWN- COON We WAre OO WAU WA OO oe 


Ww 
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DESCRIPTION OF CHANGES: 
PITITILITIITTTITT ITEC COUP CC OCCCCCOCCCEL COLL COC rE 


0484 Pete aut pees near 

= OOFF NIT BUTTON STAT equ OFFh ; all buttons open 
0484 C6 06 OOOD FF mov ds:O0_STATE ,INIT_BUTTON_ STATE ; all off 

0489 B4 00 mov ah, RS SUCCESSFUL; successful initialization 

O4BB C3 ret ; return to main driver 

O4BC pgid_ init end 


subttl PGIO_ START System Subfunction 


ree 

:weeFUNCTION HEADE SRPSSSSSASTRARSSARSHERSSSTSTRSESTRSSSSSTSSESSESSSEBeEAS 
NAME : PGID_START 
FUNCTIONAL DESCRIPTION: 


System subfunction SF START -- start the driver. This does nothing 
but return with RS SUCCESSFUL. 


PARAMETERS 
ON ENTRY: 
AH = F_SYSTEM 
AL = SF START 


ON EXIT: 
: AH = return status (RS SUCCESSFUL) 


REGISTERS ALTERED: ah 
DEFINITION MODIFICATION HISTORY 
VERSION: 
DESCRIPTION OF CHANGES. 


O4BC pgid_start proc near 

O4BC B84 00 mov ah, RS SUCCESSFUL; successful start up 
O4BE C3 ret ; return to main driver 
O4BF pgid start 


Pai tl PGID_STATE System Subfunction 

,@=sFUNCTION NPADE | ee uewcewew cece ediuutceescubeenescouesiaveeseesecueusec 
NAME : PGID_STATE 

FUNCTIONAL DESCRIPTION: 


System subfunction PGID REPORT_STATE -- report the state of this 
driver. (NOT SUPPORTED) 


PARAMETERS 
ON ENTRY: 
AH = F_SYSTEM 
AL = SF_REPORT_STATE 


: ON EXIT: 
AH = return status (RS UNSUPPORTED) 


REGISTERS ALTERED: ah, dx 

DEFINITION MODIFICATION HISTORY 
VERSION: 

} DESCRIPTION OF CHANGES: 


O4BF pgid_ state proc near 

O48F B4 02 mov ah, RS UNSUPPORTED : function not supported 
04C1 C3 ret >; return to main driver 

04C2 pgid_state 


end 
subttl] PGID_VERSION System Subfunction 
age 

-eaaFUNCTION HEADER s speeusedeetewcrds saces ue cceneasehadauadeaueccoceeee 

NAME : PGID_VERSION 

FUNCTIONAL DESCRIPTION: 

System subfunction SF _ VERSION DESC -- Report the version 

number of the driver. (Use standard system version number) 

; PARAMETERS 
ON ENTRY: 


: AH =» F SYSTEM 
AL = SF_VERSION DESC 
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1305 ; 
1306 ON EXIT: 
1307 ; AH = RS_ SUCCESSFUL 


08 : (others): see hp _ system version function. 
REGISTERS ALTERED. ah.es dit 
DEFINITION MODIFICATION HISTORY 

VERSION: 

DESCRIPTION OF CHANGES: 


04C? pgid_version proc near 

04cc B4 00 mov ah, RS SUCCESSFUL 

04C4 8B 5225 mov bx, 5225H 

04C7 BS OOD mov cx, VERSION LEN 

O4CA OE push cs 

04CB O07 op 68 

O4CC 8D 3E 0099 R ea di. cs: VERSION LAB 

0400 C3 ret ~ return to PGID main driver 
04D1 pgid_ version endp 


RRR RARER RARA AERA RRA RRA R ARR R AAA R RRR ARERR RAR ARR RARRARRARR 
0401 END_OF DRIVER: 
, LOCAL STACK USED DURING INITIALIZATION 


0401 40 [ OB 64 DUP (0) 
00 


STACK _ TOP: 


CODE ENDS 
END 


oo 
OnNUN 


fe ee ee ee ee ee be ee ee et be eb ee te ee 
WWWWWWWOUWOWWOWUW WWW WWW WWW Od WW Ww OO OD 
— 
= 


Pah &WWWWW YW WOW PID DO AI DD ID PO AID AD be be eb be ee 
WN HOW OND AWN OO OND Ua WN— OW ONMDUTABWNFH OW 


Structures and records 


Name Width # fields 
Shift Width Mask Initial 
ATTR 6905 0010 OOOB 
DEV. . . oo OOOF 0001 8000 0000 
IOCTL. a ee - « OOOE 0001 4000 0000 
IBM... . ., : 3 hy 0000 0001 2000 0000 
Kee Sue pe ooo fe ee ce a ee te o000c oool 1000 0000 
OCREM . .. ; s, Ae, Sat A 000B 0001 0800 0000 
Y utero wnat ee ah Ma +g 2. AS a <4 0005 0006 O7E0 9000 
SPEC... ., , SS of a 0004 oool 0010 00co 
CURA 2. of oe a ewe ei ok ee I 0003 0001 0008 0000 
NUL. 2.) ww, ee ee 0002 0001 0004 0000 
STOO... . fe fu hg Heine oa ooo 0001 0002 0000 
STDI Pisin, cfs ie ee sy oe hp ee i tee 0000 0001 0001 0000 
DESCRIBE... .. . . 0020 0017 
De SOURGE: ne eb oe BE. ea 0000 
D-HPHIL ID... .... 2... 0001 
BD OESC MASK. .......... 0002 
O-I1I0 MASK... . . 0003 
DO XDESC MASK . . co A 0004 
OD MAX AXIS F ete sse Sh ce woh od 0005 
D CLASS. . 0006 
D_ PROMPTS. 0007 
D RESERVED 0008 
D BURST LEN 0009 
D_WR_ REG . OOOA 
p=hO REQ Me at he I nie eee oe 0008 
D_ TRANSITION n° othe ok te ke eee hy! oe o00c 
D STATE. . each te ie oe <8. oe ee 0000 
DRESOLUTION d- BS de tm Be tn wee gos OOOE 
D SIZE _X . oe eG ‘oe & 0010 
D SIZE Y 0012 
DABS X. 0014 
DABS Y. 0016 
O REL X. 0018 
OD REL _Y. OOLA 
D ACCUM XxX. . OO1C 
D ACCUM Y........ 2 OO1E 
HPLATIR: © ook 8 a ee ee Oe 00:0 0000 
Fis ten se cat ao EP US cin cat “ie Ate OOOF ooo) 8000 0000 
DEVCFG......, 2... OOOE ooo. 4000 0000 
USRie cas A Ge Bo at Bee Ee a eo 0000 0001 2000 0000 
ENTRY... Co-ed. oe ce de UR ee Ge ee a oooc 0001 1000 0000 
TVPES 3: ts a -' oe Geos EA GP a Zac F 0009 0003 OE00 0000 
STR. Ne Pa ee Boe oe oe Me eee 0008 0001 0100 0000 
MAP _CALL a ie. « leie Me Se amnte ao bE = ah de, ta 0007 oool 0080 0000 
A. 6 oo te oe ee be SO a Ge ee 0006 0001 0040 0000 
SUBADD............ ! 0004 0002 0030 0000 
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PSHARE ssi oe 0003 0001 0008 0000 
CSHARE ew 0002 000} 0004 0000 
ROM Dyes Sate ted ” te eras ote 0001 0001 0002 0000 

bh Meade Gh ee cee tg Ohm a eG 0001 

HP_HEADER. . . . 0010 0009 ne 
DH ATR cm oA i hth we od a Eo 0000 
DH NAME INDEX... . . . . 1... 0002 
DH V DEFAULT... . . . . 1. 0004 
DH P-CLASS.. .. . . 0006 
DHcC CUASS can y ae Ge wok fou eet 0008 
OH_V_PARENT. .. ... 2. 1, 000A 
DAG: CHILD? 5 go eee ne ek ae 000Cc 
DHTMAJOR.. . . . . . OOOE 
DH MINOR... . . . . OOOF 

REQ HEADER =Sigwsi(as ss, 0017 OOOA 
RH_LENGTH. .... 0000 
RH_UNIT CODE... .. .. 0001 
RH_CMD CODE... .. . ss, 0002 
RH_STATUS ©. 0003 
RH-RESERVED . . 0005 
RH_UNIT CNT Ded on edhe 000D 
RH_END OFF 2 ww OOOE 
RH_END-SEG .. . . . . . 0010 
RHOBPR mck ne ee fa wed, 2 0012 
RHSDRIVs. j.-dr- us aur & Ge cbt 0016 

STATUS... 20 coer hea be A bw he has 0010 0005 
ERROR. cat eed, ena OOOF 0001 8000 0000 
ee av. a oer OOOA 0005 7C00 0000 
BUSY dw oy tech Hee ee ba ae 0009 0001 0200 0000 
DONE Mit ca 2 tke ok ok ce da es 0008 0001 0100 0000 
ERR TYPE... . . os 0000 0008 OOF F 0000 


Segments and Groups: 


Name Size Align Combine Class 
CODE . ee 0511 PARA PUBLIC ‘CODE’ 
Symbols - 

Nam e Type Value Attr 
ABS MOVE L NEAR 0439 CODE 
BAD CMD. L NEAR 0292 CODE 
BISR2  —_ L NEAR OFA CODE 
BUTTON DOWN. tL NEAR 0487 CODE 
BUTTON ISR a ee oa L NEAR 0470 CODE 
BUTTON TAB | eek 4 ae eG L BYTE O1F7 CODE 
BUTTON UP is he 2 a. L NEAR 048} CODE 
CHECK F SYSTEM L NEAR 0408 CODE 
CMD TABLE. L WORD 0152 CODE 
COM_MSG L BYTE O0C1 CODE 
COM NUMBER L WORD 0128 CODE 
CR Peta ee ea ee ee Number OOOD 
DEBUG an oa i Alias TRUE 
DEV_ATTR Bs oc fe we gee ae he Number AC18 
DEV_DESCRIBE ae t 0020 0030 CODE 
DEV_DRIVER . . ; ; on F PROC Q000 CODE Length =O3FF 
DEV _ HEADER ba oe 4 s 8 L 0010 0020 CODE 
DEV_INTERRUPT ... . . F PROC 0270 CODE Length #O18F 
DEV STRATEGY mk oe Swe ef F PROC 0265 CODE Length *Q00B 
DOS ENTRY... , we ig et> 2 Number 0021 
ORIVER ATTR. .. . . fot i wORD 0004 CODE 
DRIVER NAME... ee oe oh BYTE OOOA CODE 
ENO OF DRIVER Rp ee Ge Sie oR L NEAR O401 CODE 
EXIT . iy oe, ee gee Ly = L NEAR O29E CODE 
FALSE eta a, un we or &. OF Numoer O000 
FRAME COUNT. |. oh oy wt te L WORD O13A CODE 
F INQUIRE _ENTRY. . 2 hu Number OOOC 
FINS BASEHPVT Number 0004 
FINS XCHGFREE : Number  OQQOA 
FIO CONTROL... . Be Botte Number O04 
F ISR a nt A - ABS Ee, Be Number 0000 
F SYSTEM ee ern ee ee Number 0002 
GIVE TO PARENT a+ i, oy L NEAR 0480 CODE 
HPHITL ABO L BYT 0150 CODE 
HPHIL TABLE. eB ae A OR. L BYTE 0142 CODE Length =QO0E 
HPLENTRY 3 2 ge ea oe wage cs Number  OO6F 
Ic 1 te pte te ee ae L NEAR O2C8B CODE 
Ic_10 L NEAR 0363 CODE 
Ic 2 L NEAR O2DA CODE 
TC _3 L NEAR O2EF CODE 
Ic 4 L NEAR C2F6 CODE 
Ic _ 4A L NEAR O3i4 CODE 
INTT 3 aor — L NEAR Q77C CODE 
INIT BUTTON STATE. Number  OOFF 
INIT CODE. boa L NEAR Q2A7 CODE 
INIT EXIT. L NEAR 0O3C6 CODE 
INIT NO_ PORT tL NEAR O3B2 CODE 
INIT NO VECTOR L NEAR Q3AQ9 CODE 
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INIT_OK. 
INT_ENT. 
INT TABLE. 
LAST_SYNCH 


LF . 
MASK TABLE . . 
MAX PGID SYS_FN 
MBUTTON.. oo, 
MBUTTON DOWN 
MBUTTON ISR. 
MBUTTON UP | 
MNEXT BUTTON 
MOUSE INT. 
MOVEMENT ISR 
MSO_BAD_LENGTH 
MSO BLO BPB_. 
MSD CRC ERROR. 
MSD DEV CLOSE. 
MSO_DEV_OPEN 
MSD_GEN FAILURE. 
MSD INIT. 
MSD_INPUT. . 
MSD_IN FLUSH | 
MSD_IN_NOWAIT. 
MSD_IN_ STATUS. 


MSD _IOCTL_IN . 
MSD IOCTL OUT. 
MSD MEDIA_CHK. 
MSD_NOT_RDY. 
MSO_OUTPUT _ . 
MSD_OUT FLUSH. 
MSD_OUT STATUS 
MSD_OUT VERIFY 
MSD_PAPER OUT. 
MSO~READ FAULT 
MSD_REM MEDIA 


MSD_SEC_ NOT FOUND. 


MSD_SEEK ERROR . 
MSD_UNKNOWN CMD. 


MSD UNKNOWN MEDIA. 


MSD_UNKNOWN UNIT 

MSD WRITE FAULT. 

MSD _WRITE PROT 

MSE_NUM_ -BUTTON 
=}. . 


“Ss 
NO PORT MSG. 
NO_VECTOR . 
OK™MSG 
PGID DRIVER. 
PGID INIT. 
PGID-ISR.. 
PGID~OPCODE_ BAD. 
PGIO START ~ . 
PGID STATE . 
PGID SYSTEM 
PGID_SYS BAD | 
PGID_SYS CASE . 
PGID~VECT NUM. 
PGID VERSION 
PRINT STR. 

REL MOVE |. 
REQ HOR OFF. 
REQ HOR SEG. 
RH CMD CINE. 
RS_DONE | 
RS_FAIL 

RS-NO VECTOR | 
RS” SUCCESSFUL 
RS UNSUPPORTED 


SF MOUSE OVERRIDE. 


SIGN ON MSG. 
STACK PTR 
STACK SEG 
STACK TOP 
STRAT ENT. 
TEMP BUFFER. 


TRUE 

T ABSO8B 

T_ABS16. 

vr ~KC BUTTON. 
RECO8 

r RELI6 

UNSUPPORT CMD 

UP DOWN BIT. 

VERSION LAB. 

VERSION LEN. 

V_DOLITTLE 

V LHPMOUSE 


478 Driver Writer's Guide 


L NEAR 
L WORD 


ccm 
or 
<O 
4” 
mo 


Number 


or 
<O 
~~ = 
mo 


NEAR 
NEAR 
NEAR 
NEAR 
NEAR 
NEAR 
NEAR 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 


Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 


oat ell col ell ll ol ol 8 
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2 
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Number 
Number 
Number 
Number 
Number 
Number 
tL NEAR 
Number 
L BYTE 
Number 
Number 
Number 


CODE 
CODE 


Length 


Length *0015 
000 
#0082 
=0003 


#0003 
eOOleE 


*000F 


«0005 
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V SINPUT ...... ee, Number OO2A 
VESYSTEM 2-0 2 ky ae geo dod Number 0012 


40380 Bytes free 


Warning Severe 
Errors Errors 
0 0 


Rese ee & Bee ee oe we OD 

ABS MOVE ws wi ti 100 10228 

ATIR 2 no ood 6 oe Shae wok 768 263 

Bicckec toch Ge-sa thou Ge ed See oe ©2098 

BAD CMD...» 1 ws 83 615 6238 
BIGR2> uit fF at Gk the eas 498 5020 

BUSY foc oe cae Mee ede eG 928 

BUTTON DOWN... .. . . . . . . +1093 »=©10978 

BUTTON_ISR _ 984 10808 

BUTTON_TAB .. . . eu 496 4994 

BUTTON_UP. 10948 

CHECK F SYSTEM. ....... . ~~ 907 9114 

CLR She! ek ee - 768 

CMO TABLE. |... .... . . 387% 619 

COOE.. ee ee SIH 2583 255 898 1341 
COM MSG... .. . 2... 3388-702 

COM-NUMBER .. . . . . . . . . . 39808 = 432 891 604 759 
CR. 1S 320 332 338 338 348 349 354 
CSHARE.. ......... 2038 

DEBUG... . ..  .. sw S0e 

DESCRIBE... ws 1668 197 

DEG eee Se eke Se ot a ee a 76% 

DEVCFG . 2038 

DEV ATTR . . 2738 274 

DEV_DESCRIBE 2848 

DEV_DRIVER 2588 866 

DEV-HEADER __. 2748 

OEV-INTERRUPT. 265 s008 865 

DEV STRATEGY 264 5928 596 

OH ATR... 1538 

DH_C_CLASS 1574 

DH MAJOR 1608 

DH MINOR | 161% 

DH_NAME INDEX. 1544 

DH_P_CLASS 1568 

OHV CHILD . 1598 

DH_V_DEFAULT 1558 

DH_V_PARENT. 158@ 1112 

OONE. . ssCi«; 928 631 

DOS ENTRY. 1408 681 819 828 835 
ORIVER_ATTR. 2638 

DRIVER NAME . 2668 

OD ABS X. 190@ 1022 1023 1037 1088 
D_ABS_Y 191@ 1029 1030 1038 # 1089 
O~ACCUM_X 1948 

O_ACCUM_Y. 1958 

O~BURST_LEN. 1824 

DICLASS. . 1758 

D_DESC_MASK. 1718 

D_HPHIL_ID 1708 

D_IO MASK. 1728 

D™MAX AXIS 1748 

D_PROMPTS. 1788 

DO RD REG 1848 

DTREL_X. 192® 1025 1032 10864 
D-REL_Y. 1938 1056 

O RESERVED 1818 

D RESOLUTION 1878 

DTSIZE_X 188% 

D”SIZE_Y 1898 1027 

D_SOURTE 1688 

OTSTATE. | 1868 1095 10099 1218 
O~ TRANSITION 185® 1090 

OD WR REG . 1838 

D_XDESC_MASK 1738 

END OF DRIVER. 850 13318 

ENTRY... . 2038 

ERROR. 920 626 

ERR TYPE 928 

EXIT . 6318 863 

FALSE... . 4st 49 

FRAME COUNT. _ . 3718 ©6439 452 460 
F INQUIRE ENTRY. 2208 778 
F-INS_BASEHPVT 2128 

FINS _XCHGFREE 2138 793 

F710 TONTROL . 2188 806 

FISK... 2168 52) 570 906) = 1A} 
F_SYSTEM 2178 »3=©912 
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GIVE_TO_PARENT ........ . 1039 1064 


HP ae ee ee 0 | 
HPHIL ADD. 5 | | | |) ) 3 g2e 
HPHIL TABLE... . . ) |) ) )) 378% 
HP_ATTR. |... | | _ 

HP_ENTRY | 
HP_HEADER. 


mem NAD 
ane e808 


Lom 
z 
| oon) 
fa 
i, 
Cc 
~4: 
a" 
ok 
is 
a 
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> 
ce ee ee ee ee ee” Pe ee eee ee 
mt 
_— 
WA @ ~~ OOO IO DOD 
s 
- 
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Ne DAD & b= Or © ~1 00 ~ 00 
OUNA co OOO WAWO 
esas 8&8 S822 B06 


TSR. 
re eee en go Be Sys he ee Gee ae. 376% 462 


OO NODe OKA COM Cm ONY! UNNI O 
W OANUWDEONDaWNUNNOBD KUTW 


Law] 
Ss @aeas 


MAP CALL. . 2...) . 2098 
MASK TABLE . oe ee.) 3668 © (770 
MAX_PGID SYS FN. . |. . | | | | #211489 )= 1180 
MBUTTON... .. 2 2...) 7S 535 
MBUTTON_DOWN ......... , 480 487 
MBUTTON_ ISR. .. . . . | | |) ] sags 491 
MBUTTON-UP 7) | |) tt tl ge 

MNEXT BUTTON. . . . |). |] ) 478 532 
MOUSE_INT.. Eked -_ 763 
MOVEMENT ISR . 
MSD_BAD_LENGTH 
MSD_BLD_BPB. . 
MSD_CRC_ERROR. 
MSD_DEV_CLOSE. 
MSD_DEV_OPEN _ 
MSD_GEN FAILURE. 
MSD_INIT . . 
MSD_INPUT. _ 
MSD_IN FLUSH . 
MSD_IN_NOWAIT. 
MSD_IN STATUS. 
MSD_IOCTL_IN . 
MSD_IOCTL_OUT. 

MSD _MEDIA CHK. 
MSD_NOT_RDY. 

MSD OUTPUT _ . 
MSD_OUT FLUSH. 
MSD_OUT STATUS 
MSD_OUT_VERIFY 
MSD_PAPER OUT. 
MSD_READ FAULT 
MSD-REM MEDIA. _ 
MSD_SEC NOT FOUND. 
MSD SEEK ERROR . . 
MSD_UNKNOWN CMD. . 
MSD_UNKNOWN” MEDIA . 
MSD_UNKNOWN” UNIT 
MSD_WRITE FAULT. 
MSD_WRITE_PROT 
MSE_NUM BUTTON 
MSI-1. 7... 


612 


614 


627 
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DORM ORK OR KOR Rr NWWNONWNNNNNN EH WWONOOF 
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845 
441 446 
598 


NO PORT MSG... .. . . . s,s 3408828 
NO-VECTOR. ....... .. ) 350@ 817 
NUE - 3 ms ee eee ee ee RS 

OCREM. . 2 ww 768 

OK MSG _ nn Ky f SE Ti 
PGID DRIVER. .......... ~~ +787 899 
PGID-INIT. ......  . . . ) 4478 8612158 
PGID_ISR Bah AO tae Seas, ee 

PGID OPCODE BAD. 

PGID START . . 
PGID STATE . 
PGID SYSTEM. 
PGID™SYS BAD . 
PGID_SYS_CASE. 
PGID_VECT_NUM. 
PGID VERSION 
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1096 11108 


573 781 796 810 843 1113 


685 687 69448 


8378 


463 
332 338 338 349 349 355 


450% 

551 5788 
905% 926 
1222 

1115 

1256 

1289 

1181 

1180 

566 804 
1327 


676 


RS-232 Mouse Driver 


PRINT_STR. 
PSHARE 


REL_MOVE .. 
REQ_HDR OFF. 
REQ HDR SEG. 
REQ HEADER 

RH BPR. 
RH_CMD CODE. 
RH_CMD_ LINE. 
RH_DRIV.. 
RH_END OFF 
RH_END SEG 

RH LENGTH. 
RH_RESERVED. 
RH_STATUS. . 
RH_UNIT CNT. 
RH UNIT _CODE 
ROM. 
RS DONE. 
RS-FAIL. | 
RS NO VECTOR . 
RS SUCCESSFUL. 
RS_UNSUPPORTED 


SF MOUSE OVERRIDE . 


SIGN ON MS 
SPEC. |, 
STACK PTR. 
STACK SEG. 
STACK TOP. 
STATUS 


STRAT ENT. 
SUBADD 
TEMP BUFFER. 
TRUE... 
TYPE 


T_ABSOS. 
TIABSI6. . 
T_KC_BUTTON. 
TTRELOB. . . 
TIRELILE. 


UNSUPPORT_CMD. 


UP_DOWN BIT. 
VERSION LAB. 
VERSION LEN. 
V_DOLITTLE 
V_LHPMOUSE 
VISINPUT . 
V7SYSTEM 

x. 

Y. 

Z. 
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1254 
923 


856 


461 


825 
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APPENDIX H 


H. ASCil AND SCANCODE CONVERSION 
TABLES 


The following tables provide information for decimal-hexadecimal-ASCIl conversions and 
Keystroke-scancode-Keycode conversions. 


Table H.1 


Decimal-Hexadecimal-ASCIl Conversion 


Dec Hex ASCII Dec Hex ASCII Dec Hex ASCII 


Dec Hex ASCIil 


0 O00 NUL 32. 20 SP 64 40 @ 96 60 ' 
1 O01 SOH 3321 | 65 41 A 97 a 
2 O02 SIX 34. 22 =" 66 42 B 98 b 
3 03 &ETX 35 23 # 67 43 C 99 C 
4 04 €E0OT 36 24 «¢ 68 44 D 100 d 
5 05 &NQ 37 25. 69 45 €£ 101 e 
6 06 ACK 38 26 & 70 46 F 102 f 
7 O7 BEL 39 27 71 47 = G 103 g 
8 08 BS 40 28 ( 72 48 4H 104 h 
9 O09 HT 41 29 CC) 73 = «4&9 105 | 
10 OA LF 42 2A * 74 4A J 106 
11 OB VW 43 2B + 75 4B K 107 k 
12 OC FF 44. 2C «CC 76 4C) OL 108 | 
13. OD CR 45 2D — 77 4D OM 109 m 
14 OE£ SO 46 2E | 78 GE N 110 n 
15 OF SI 47 2F | 79 GF O 111 O 
16 10 DLE 48 30 0 30 50 P 112 0 
7 41 ‘DG 49 31 1 81 51 Q 113 Q 
18 12 DC2 50 «6332 «(2 82 52 R 114 r 
19 13 DC 51 33 3 83 53 S 115 : 
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Dec Hex ASCII Dec Hex ASCII Dec Hex ASCII Dec Hex ASCIl 


14 


peel tnt eas as 


a = = = / = «= => => / — => > 
TAMVA DYPOAWAI NOW 


Table H.2 


Scancode Conversion Table 


Key AT Hp Unshifted Shifted | 
Number Scancode Scancode Key Cap ASCII Hex  ASCIi Hex Control Alt 


O76H O01H ESC esc 1BH 
O16H OO02H ‘4! aa 
O1EH O03H 


O26H O04H 
O25H 
O2EH 
O36H 
O3DH 


O3EH 
O46H 
O45H 
O4EH 
O55H 


O66H 
OOOH 
O15H 
O1DH 
O24H 


O2DH 
O2CH 
O35H 
QO3CH 
O43H 
O44H 


00/78H 
00/79H 


O0/7AH 
00/7BH 
O00/7CH 
O0/7DH 
OO/7EH 


O0/7FH 
00/80H 
00/81H 
00/82H 
00/83H 


OWoOWOIN WUIA WyhN — 


kspace 


WM ® 


C 
b 


on 


oat 
11H 

00/12H “ 
00/13H 
00/14H 
00/15H 
00/16H 


00/17H 
00/18H 


O7~C<AA SOAS 
Oe Sao ooo 7 


Sid<daligg? 
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Key AT Hp Unshifted Shifted 
Number Scancode Scancode Key Cap ASCIl Hex  ASCIl Hex Control Alt 


00/19H 


00/1EH 
00/1FH 
00/20H 
00/21H 
00/22H 


00/23H 
00/24H 
00/25H 
00/26H 


~ 


W wy 


=stho Ae 


~ 
od 


. 
~ ~ 
~ 


Left Shift 
xs 


~ ~ | 
NI. 
~ 


00/2DH 
O0/2EH 
00/2FH 
00/30H 
00/31H 


‘x! 
ae 
‘VY! 
B’ 
N’ 


Az 


~ 


| Vy 


/ 

Right Shift 
Prt Sc oe - O0/72H 

Alt =— a 
Space a ca 20H 20H 
Caps lock - ——— a 

F1 - - QO/5EH QOO0/68H 


O0/5FH 
O00/60H 
00/61H 
00/62H 
00/63H 
00/64H 
00/65H 
00/66H 


00/67H 


00/69H 
O00/6AH 
00/6BH 
00/6CH 
O0/6DH 


O0/6EH 
O0/6FH 
00/70H 
00/71H 
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None Or 
NumLock 
and Shift 


NumLock 


Key AT Hp or 
Number Scancode Scancode Key Cap Shift 


Control 


105 084H O54H 
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Num lock _ 
ScrLck = 
Home E 
t ‘g' 
Pg Up ‘g' 


Sys req - 


00/47H 
00/48H 
00/49H 


3AH 
00/4BH 


00/4DH 
2BH 


00/4FH 
00/50H 
00/51H 
00/52H 
00/53H 


0077H 
00/84H 


00/73H 
00/74H 


00/75H 
00/76H 


Key AT Hp Unshifted Shifted 
Number Scancode Scancode KeyCap ASCII Hex ASCIl Hex Control Alt 


- undef. 
OSBH - undef. 
OSCH - undef. 


- undef. 

Unlabled-L OO/D7H O0/BDH O0/A3H OO0/89H 

Unlabled-R OO/D8H O0/BEH OO/A4H OO/8AH 
113 O60H CCP-Up O0/D9H O0/BFH OO/ASH OO0/8BH 
111 061H CCP-Lft O0/DAH O0/COH O0/A6H OO/8CH 

CCP-Dn O0/DBH 00/C1H O0/A7H OO/8DH 

CCP-Rht 00/DCH O0/C2H OO/A8H OO0/8EH 


110 O64H CCP-Home O0/DDH 00/C3H OO/A9H OO/8FH 
117 O65H CCP-PgUp OQQ0O/DEH 00/C4H OO/AAH OO/90H 
112 O66H CCP-End O0/DFH 00/C5H OO/ABH OO0/91H 
119 067H CCP-PgDn OQO/EOH 00/C6H OO/ACH OO0/92H 
116 O068H CCP-Ins 00/E1H O0/C7H OO/ADH O0/93H 
120 O69H CCP-Del O0/E2H 00/C8H OO/AEH O0/94H 
114 O6AH CCP-CNTR OO/E3H 00/C9H OO/AFH OO/95H 

O6BH - undef. O0/E4H OO/CAH 00/BOH O00/96H 

O6CH - undef. OO/ES5H 00/CBH 00/B1H OOQO/97H 


- undef. 00/E6H O00/CCH 00/B2H O00/98H 


. 00/E7H O0/CDH 00/B3H O0/99H 

O6FH - undef. O00/E8H O0/CEH 00/B4H OO0/9AH 
121 O70H f1 O00/E9H O0/CFH 00/B5H OO0/9BH 
O0/EAH 00/D0H 00/B6H OO0/9CH 
O0/EBH 00/D1H 00/B7H O0/9DH 


O00/ECH O00/D2H 00/B8H O0/9EH 
125 O74H f5 O0/EDH 00/D3H 00/B9H OO0/9FH 


126 O75H f6 OO/EEH 00/D4H O0/BAH OO/AOQH 
127 O76H {7 O0/EFH 00/D5H O0/BBH OO/A1H 
128 O77H f8 00/FOH 00/D6H OO/BCH OO/A2H 


O78H through 7FH—undef. 
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APPENDIX | 


l. HEXADECIMAL ARITHMETIC 


For use as a quick reference, the following tables are provided. Table |.1 shows the conversion 
from decimal-hexadecimal. Table |.2 is a simple hexadecimal addition table and table |.3 is a 
simple hexadecimal multiplication table. 


Table |.1 converts from hexadecimal to/from decimal for the first 256 decimal numbers. 


Table |.1 


Decimal to Hexadecimal Conversion Chart 


Dec Hex Dec Hex Dec Hex Dec Hex 
QO 00 21. 35 42 2A 63 3F 
1 01 22 16 43 2B 64 40 
2 O2 23 1/ 44 2C 65 41 
3 03 24 18 45 2D 66 42 
4 04 25 19 46 2E 67 43 
5 O05 26 1A 47 2F 68 44 
6 06 2/7 1B 48 30 69 45 
7 QO7 28 1C 49 31 70 46 
8 08 29 1D 50 32 71 47 
9 QO9 30 jE 51 33 72 48 

10 OA 31 IF 52 34 73 49 
11 OB 32 20 53 35 74 4A 
12 OC 33 21 54 36 75 4B 
13. OD 34 22 55 3/7 76 AC 
14 OE 35 23 56 38 77 4D 
15 OF 36 24 57 =—39 78 4E 
16 10 37 25 58 3A 79 4F 
17 11 38 26 59 3B 80 50 
18 12 39 27 60 3C 81 51 
19 13 40 28 61 3D 82 52 
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Dec 


127 
128 
129 
130 
13) 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 


Dec 


170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 


Dec 


213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
22/7 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 


Table |.2 


Hexadecimal Addition 


T™MODN|WPowOnNn!|N 
T™AMONWwWPwon wo 


TIMODMNWDWP|I OONDU VU 
© 


ONIDPUWOODN|(DUBWHN] N 


1 

1 

2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
C 
D 


— “T1ITTN 
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Table |.3 


Hexadecimal Multiplication 


MONWP]lOWmDWYUNAU|AWN Oo 


OSOODVDVDOD/DVDIDODO/(/OOOOO| O 


1E 2D 3C 4B 5A 69 78 87 96 A5 B4 C3 D2 €E1 


™”T 
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Glossary 


Adapter: A circuit board containing electronic circuitry that interfaces a peripheral to the 
system processor board. 


Adapter Card: See ADAPTER 


Alphanumeric Display Mode: One of the Video Display Adapter modes. When this mode is 
selected, data is displayed in character cells, organized in rows and columns on the screen. 


Application Programs: Software that performs application specific tasks. Word processors, 
spreadsheets, and data bases are examples of application programs. 


Barcode Reader: An input device that is used to scan surfaces containing barcodes. The 
barcode reader converts barcodes into scancode data format, and transmits the scancodes to an 
input interface. 


Baud Rate: The rate a signal changes state. When used with relationship to RS-232 ports, it is 
synonymous with the data transfer rate, expressed in bits-per-second (BPS). 


BIOS: Basic Input/Output System. The BIOS is the code module that contains the drivers that 
constitute the software interface between the hardware, and system software and application 
programs. 


Bootstrap: The process of initializing the system and loading system software after a reset. 


Bucket: A data structure used by the EX-BIOS string functions for alphanumeric string 
management. 


Character Code: A word returned by the keyboard driver indicating a key stroke. The character 
code consists of a keyboard scancode, and either an Extended (OOH) or ASCII character. 


Checksum: An error-checking protocol used to verify the integrity of a block of data or code. 
Each byte or word in the block is summed, then added to a Checksum Byte. The block of data or 
code is presumed valid if this sum equals a predefined value, usually 0. 


Checksum Byte: A byte added to the sum of a block of code or data to produce a valid sum. 


Child Driver: A child driver is called by another driver when it is unable to perform a function 
requested of it. Child drivers perform lower level or more hardware specific tasks than their 
calling drivers. 


Clipping: The process utilized when dealing with graphics coordinates outside of the logical 
coordinate space. The Input System clips coordinates so that they don’t exceed the boundaries of 
the logical coordinate space. 
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CMOS Memory: RAM memory on the Processor Board that is powered by both the system 
power supply and battery. When the system power is turned off, the contents of the RAM 
memory are preserved by the battery. 


Code Module: A group of related processor instructions. 
Code Segment (CS): The segment address of the code module currently being executed. 


Coprocessor: An add-on processor that works with the 80286 processor that is found on the 
SPU. The 80287 Is an example of a specialized coprocessor for floating point arithmetic. 


Cursor Control Pad: The keypad containing cursor control keys. 


Cylinder: A term used with multi-platter disc mechanisms, a cylinder is a group of sectors 
having the same track number on each of the platters. 


Daisy Chain: A method of linking devices together in a serial configuration. Input devices on 
the HP-HIL loop are connected in a daisy chain. 


Data Segment (DS): The segment address of the data currently being accessed. 
Data Structures: A related group of data fields. 


Describe Record: A data structure utilized by the Input System which contains information 
characterizing an input event. 


Device: A physical piece of hardware, e.g. a touch screen, mouse, keyboard, dot matrix printer, 
ThinkJet, or LaserJet. 


Disc Partitions: A group of cylinders within a hard disc volume allocated to a specified 
operating system, and its associated programs and data. 


Disc Volumes: A group of cylinders comprising a logical disc. The optional 40 Mbyte hard disc 
is divided into two disc volumes containing 20 Mbytes each. The optional 20 Mbyte hard disc 
contains a single volume. 


Divide By Zero Interrupt: The 80286 executes this interrupt any time a divide by zero 
operation is attempted. The vector to the service routine for this interrupt must be stored in 
memory locations 0000:0000H—0000:0003H. 


DOS: Disc Operating System. 


DOS Installable Device Driver: A device driver designed to be dynamically installed by DOS. 
DOS installabie device drivers may be used to add EX-BIOS drivers to the system. 


Driver: Code that interfaces to either a physical ‘device’ or another driver. 


Driver Header: A data structure contained in the data area of each EX-BIOS driver. The driver 
header contains data fields that specify the attributes, mapping, and other parameters of the 
driver. 


EX-BIOS: Extended BIOS. A set of proprietary HP drivers that provide support for various system 
features. 
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Extra Segment (ES): The segment address of the extra data segment currently being accessed. 


Functions: Code modules within a driver that perform specific tasks. Individual driver functions 
are selected when a driver Is called. 


Function Keys: The ten industry standard keys labeled F1—F10 on the keyboard. See also HP 
SOFTKEYS. 


GID: see GRAPHIC INPUT DEVICE. 


Graphic Display Mode: A video display adapter mode in which all positions on the screen are 
addressable as pixels. 


Graphic Input Device: An input device that generates positional and/or button state data. A 
mouse, tablet, and touch screen are examples of graphic input devices. 


Graphics Sprite: See SPRITE. 
Hardware Interrupts: Requests for interrupt service generated by the hardware components. 


Head: The magnetic device that reads and writes data from a disc drive. Disc drives have a head 
for each recording surface in the mechanism. A flexible disc has two heads, while a hard disc 
head count can vary depending on the drive being used. The optional 20MB disc has two 
platters and four heads. 


?- Hexadecimal: Numbers expressed in base 16. Hexadecimal notation is used throughout this 
manual to represent binary data. hexadecimal digits are represented with the numbers 0-9 and 
letters A-F. The hexadecimal numbers are indicated with an uppercase ‘H’ as their last character 
(i.e., 17H). 


HP Extensions: Additional functions added to industry standard drivers that support EX-BIOS 
features and/or provide additional flexibility in programming industry standard system 
capabilities. 


HP Global Data Area: A data structure located in the EX-BIOS Data Area containing variables 
common to two or more EX-BIOS drivers. In addition, the stack used by the EX-BIOS drivers is 
located here. 


HP Softkeys: 8 function keys labeled f1-f8 on the keyboard. These keys can be mapped to 
return their own scancode, or they may emulate their respective industry standard function keys 
(F1—-F8). See also FUNCTION KEYS. 


HP__ENTRY__CODE: The code module that dispatches the EX-BIOS interrupt (6FH) to the 
selected driver. 


~~ HP__ENTRY: The symbolic reference for the EX-BIOS interrupt, 6FH. 


HP-HIL Controller: The hardware that provides the electrical interface to the HP-HIL link and 
supervises the communication protocol. 


HP-HIL Link: The electrical interface and communication protocol utilized to connect HP-HIL 
input devices. 
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HP-HIL Major Address: The primary address of an HP-HIL device. This is typically the link 
address of the device. 


HP-HIL Minor Address: The secondary address of an HP-HIL device. 


HP-HIL Universal Address: Used to broadcast commands to all HP-HIL devices. The Universal 
Adaress is implemented as Address 0 in the HP-HIL protocol. 


HP__VECTOR_ TABLE: A data structure containing the IP, CS, and DS of all EX-BIOS drivers. 
This data structure is utilized by the HP__ENTRY__CODE to branch to the selected EX-BIOS driver. 


Input System: A set of EX-BIOS drivers that service the input devices. The Input System 
supports the keyboard, HP Mouse, HP touch screen, and other HP-HIL input devices. It can be 
expanded to encompass non-HP-HIL input devices. 


Instruction Pointer (IP): The offset from the base of the code segment of the next instruction 
to be executed. 


Interrupt Service Routine: A code module, and its associated data structure(s) that responds 
to a hardware interrupt. 


ISR Event Record: A data structure used by the Input System which contains information 
characterizing an input event. 


Interleave: The number of physical sectors on a disc drive skipped when reading consecutive 
logical sectors on the same track. See also STAGGER. 


Interrupt Vector: A data structure used by the 80286 to branch to a service routine or an 
interrupt. Interrupt vectors are located in the first 1024 bytes of system memory. Each interrupt 
vector occupies 2 words of memory and contains the IP and CS of the interrupt service routine. 


KB: KiloBytes. 1024 bytes. 
Keyboard: The physical keyboard. 


Keyboard Controller (8041): The 8041 keyboard controller. The 8041 provides industry 
standard keyboard compatibility, and serves as a buffer between the STD-BIOS keyboard drivers 
and the Input System. 


Keyboard Modifier: One of the special keyboard keys that modifies the interpretation of the 
other keys. The keyboard modifiers are the CTRL, ALT, SHIFT, CAPS LOCK, NUM LOCK, and 
SCROLL LOCK keys. 


LED Mode Indicators: The LEDs located on the keyboard that indicate the state of the CAPS 
LOCK, NUM LOCK, and SCROLL LOCK keyboard modifiers. 


Logical Driver: A driver responsible for interfacing with the Operating System or application. 
Logical Keyboard: A set of drivers within the Input System that service the physical keyboard. 
MB: MegaByte. 1,048,576 bytes. 
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MICKIES: The number of physical coordinates per inch reported by a mouse or other relative 
GID device. 


Mouse: A GID device that reports relative motion coordinates based on its motion. A mouse 
will also report the state of its buttons. 


MS-DOS: See DOS. 


Multi-Tasking: The ability of a CPU to perform multiple jobs or tasks simultaneously. Multi- 
tasking is accomplished by dividing CPU execution time between the different tasks. If this task- 
switching is performed quickly enough, the illusion of simultaneous execution occurs. 


Numeric Keypad: The keypad containing numeric and modifier keys. 


NMI: Non-Maskable Interrupt. This is an 80286 interrupt line used to report system error 
conditions. This interrupt is mapped by the 80286 to Interrupt vector 02H. 


Operating System: The system software that provides access to system resources for 


application programs. The operating system manages input and output, data and program files, 
and system memory. 


Palette: The set of all possible colors the Video Display Adapter can produce. The Multimode 
Video Display Adapter has a palette of 16 colors. 


Parallel Port: An I/O port that transmits and receives data a byte at a time. The parallel ports 
are typically used to interface to printers. 


Parent Driver: A parent driver is called by another driver when the second is unable to perform 
a function requested of it. Parent drivers perform higher level or more system software oriented 
tasks than their calling drivers. 


Physical Driver: A driver responsible for interfacing with the physical hardware. 
Pixel: A dot on the screen in the graphics modes. 


Polling: The process of periodically determining the status of a device. Polling is used to 
determine if peripheral devices have data or are ready to accept data in non-interrupt driven 
systems. 


Post: Power On Self Test. The POST process is executed each time the system is powered on or 
a hard reset occurs. 


Processor Interrupts: Interrupts generated by the 80286 processor in response to error 
conditions or processor exceptions. 


Protected Mode: One of the two modes that the 80286 can operate in. The Protected mode 
provides virtual memory addressing, on-board memory management and protection, and task 
switching to support multi-user, multi-tasking system software. 


RAM BIOS: The interface between DOS and the ROM BIOS. It is dynamically loaded at system 
boot with DOS. 
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Real Mode: One of the two modes that the 80286 can operate in. The Real mode provides 
compatibility with the 8086 family of microprocessors. 


Real-Time Clock: A clock circuit that maintains the correct time whether the system is on or 
off. The real-time clock is powered by both the system power supply and battery. When the 
system power is turned off, the clock continues to operate from the battery. 


Return Status Code: A code returned by the EX-BIOS drivers that indicates the status of the 
function requested. 


ROM BIOS: The set of EX-BIOS and STD-BIOS drivers. These code modules are contained in 
ROM modules on the Processor Extension Card. 


ROM Module: Code and/or data stored in an EPROM or ROM. 


RS-232C: An EIA standard for a serial data interface. Often used as a synonym for serial when 
referring to system ports. 


Scaling: The process of adjusting physical graphics coordinates to fit in a proportionately larger 
or smaller logical space. The Input System scales the coordinates received from a tablet to fit into 
its logical space. 


Scancodes: Codes returned by the physical keyboard to indicate key makes and breaks. 


Sector: A physical location on the disc where a block of data is stored. Disc surfaces are divided 
into concentric rings called tracks. These rings are in turn divided into sectors. 


Serial: To transmit data one bit at a time, serially. Used to indicate system ports that transmit 
data in this fashion. See also RS-232C. 


Single Step Interrupt: A processor interrupt generated after each instruction if the Single Step 
flag is set. This interrupt is mapped by the 80286 to Interrupt vector 01H. 


Software Interrupts: Interrupts generated by the 80286 INT ‘n’ instruction where ‘n’ is the 
interrupt number. 


Sprite: A graphics cursor. The sprite is controlled by the Inout System V__STRACK and 
V__LHPMOUSE drivers. 


Stagger: Disc stagger is the track to track offset between logical sectors. Stagger increases disc 
performance during sequential read operations by adjusting for track to track access time. See 
also INTERLEAVE. 


STD-BIOS: The set of drivers that execute the industry standard BIOS functions. 
System Software: See Operating System. 


System Strings: Character strings stored in memory. Each EX-BIOS driver has a system string 
associated with it. System strings are designed to provide a simple method for system software 
to access them. In addition, their implementation provides a simple and effective method of 
localization. 
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Tablet: A Graphics Input Device (GID) that generates absolute graphics coordinates. 


Timeout: An indication (for example an interrupt) that indicates that a predetermined time has 
elapsed waiting for an event to occur. Timeouts are used to prevent the system from hanging up 
waiting for an event to happen that doesn’t. For example, a timeout can be used to abort a print 
operation if the printer does not return a ready status. 


Timer Tick: An interrupt generated by the system timer. It is initialized to produce 
approximately 18.2 timer ticks per second. 


Touch Screen: An HP Graphic Input Device (GID). allows a user to input data by physically 
touching the display screen. 


Track: An Input System driver that moves a Sprite on the display screen in response to graphics 
motion received from GID devices. 


Tracking: The process of moving a Sprite on the display screen in response to graphic motion 
received from GID devices. 


Typematic Delay: The amount of time a key must remain depressed before the keyboard 
enters the typematic or repeat mode. 


Typematic Rate: The rate at which make scancodes are transmitted by the keyboard when it Is 
in the typematic or repeat mode. 


Video Attributes: Video characteristics of characters displayed on the Video Display Adapter. 
Video attributes include reverse video, blinking, underline, and high intensity. Video attributes 
only apply to characters displayed in the alphanumeric modes. 
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